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c-t:ree Plus* 

embedded database engine 
offers Superior Indexing 
Technology - the key to 
performance, data integrity, and 
concurrency* c-tree Plus offers 
direct record-oriented C and C++ 
APIs with an industry-standard 
SOL interface that allows use of 
any combination of APIs within 
the same application* 
Furthermore, we offer source 
code access for intimate 
programming controL unmatched 
portability, and developer-to- 
developer technical support* 

Heterogeneous Environments 

c-tree Plus and c-treeSQL" 
Servers are the perfect solution 
for your mixed platform 
environments. Mac servers to 
Windows clients? No problem. 
Linux Servers to Mac clients? No 
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of crass^platform development 
solutions. Byte incompatibility 
between platforms Is handled 
seamlessly with our Uniformat 
data handling technology. 

tow TCO 

c-tree is priced affordably, 
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Ownership (TCO) is important to 
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database. 

Easy Deployment 

c-tree Servers are designed for 
ease of use and deployment as 
well. Out of the box, our servers 
can be installed and running in 
minutes. 
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IN THE TRENCHES * by Schoun ifRegan 


“Why Am I The Only 
Woman At This Table?” 


F or this month's installment of Schoun Regan's new monthly column, "In 
Tlie Trenches", Schoun took some time out of liis busy schedule at this 
year's WWDC to have a chat with Andrina Kelly, a Senior IT staff member 
at C.O.R.E Feature Animation in Toronto. We’re sure you'll enjoy their discussion! 


Schifun Kc};an: How long have you Ikjcii working 
with Macs? 

Andriiia Kelly: Since iny first 512k when I was very 
young* 

SR: Docs your networking background conies from 
tliosc early years too? 

AK: No, 1 was working in die L)K ai a classical CD 
pr( Kind ion company full of Macs and someone 
liad tc^ take on the responsibility and that was me, 

SR: Do you think a lot of people start that way? 

AK: Probably* I think tliere are a lot of self tauglu 
learners who came on die same way* 

SR: Did you pick up yottr programming at the same 
lime? 

AK: Probably over the past two years. It's 
something I always avoided because it was 
something my mother did it. It's something 1 
slK:>nld have taken more seriously when I was 
younger. 

SK; Do you allow scnpis to interoperate l>eLween eacli 
odier? 

AK: Our rendering department needed a pc>p up 
messaging system so they could alert the floor 
when there were Issues ot they needed them to 
know something quickly* All of our rendering 
pods use LINUX, so the be.st way for them was 
to send out a shell script but that also 
incorporated into an AppleScript on the user 
machines so it would pop up a message. 1 don’t 
know of any commercial pn^duct that would 
have covered it, because this covers bcDth LINUX 
and Mac OS X* 

SR: So CORK benefits from this. Tell me more alxjul 
CORE. 


AK: CORE is quite a diverse company. Recently they worked 
with a San Francisco company and put together a 
proposal for Disney to pm out a feature animation tilm. 
WeVe been working on it for about 2 _ -5 years now and 
it is just coming up to completion and should l>e released 
in April 2006 called The Wild. 

SR: Your role at CORE is? 

AK: f'm one of the System Administrators with main focus on 
the Macs. 

SR: Whafs your biggest day-to-day struggle? Your biggest 
headache? 

AK: Interopenibility. Allowing someone w^htfs used io 
working on UNI.TX, used lo w(?rking in a terminal 
environment, going over to a Mac, opening up the 
Terminal and going, “I'm going to go into tfiis direciory 
and open up tliis file” and having it work exactly the same 
for them, 

SR: ‘lhal said, how easy did the LINUX users lake to the Mac? 

AK: From wbai tVe beard, ihc 7 LOVE it! (Laughs) I can 
name several people that I've been working with in 
the last couple of years who've gone out and got a 
Mac. 

SR: If you could take one thing from the LINUX environment 
and move it over lo Mac OS X to convert those die hards, 
what would that pne thing Ix^? 

AK: (Silence.laughter and a long pause) 1 think the X 

windows to Innder tnmsition Is a linle awkward for some 
people* 

SR: It is easy lx.Mng female in a male dominated industry? 

AK: I was just talking about this with one of my 
colleagues today, it's a question I love to ask 
wdienever I’m in a large environment of men, "Why am 
1 the only woman at this table?'' I find that women are 
a lot more patient and a lot more programmatic about 
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Relax, We’ve Got You Covered... 

introducing 
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( Vital Stats 


Years in IT industry : 5 

Place of Employment: 
C.O.R.E. Feature 
Anirnation/C.O.R.E. Digital 
Pictures 450-500 people, 
Toronto, Canada 


Computers: Approximately 1 
per user. 1/3 Macs 2/3 
LINUX 500 Blade Dual 
Processor iBM Render Farm 
32 Dual 2G Xserve Cluster nodes for Shake rendering and Final Cut 
Pro rendering BlueArc, NeLApp appliances, and Xserve RAlDs 
totaling about 100TB. 

Main Applications: Houdini, Final Cut Pro, Shake 
Prograiiiniing UingLiagesr Shell Scripting, AppleScript, P\TIION 


copy is so significantly slower on OS X than on other 



things. I know for troubleshooting 
especially the number of women Fve 
seen LroubleshooLing lend get lo the 
answer a lot quicker than men, I find men 
get frustrated more quickly, 

SR: Any advice? 

AK: Don’t gel di.scouraged and don’t lx? put off. 

SR: Your OS X Servers, specifically render 
farms? 

AK: We!) Services, LDAP Masters and Replicas, 

My SQL, PUP, and failover setup All 
authentication is done with the OS X 
servers. 

SR: Using Kerlx^ros? 

AK: Not at the moment, llie infrastrucmre is all 
there tiiough. 

SR; How do tlie Xserve RAlDs perform? 

x4K: 1 have not had a failed drive in over two 
years. I couIdnT be more pleased with the 
hardware from Apple. We had die first G5 
cluster nodes in Canada. Since w'e’ve 
turned them on, 1 have not had a 
hardware failure. 

SR: Being in the center of the IT industiy in 
Canada in Toronto, what trends do you 
see? 

AK: Anytliing media ba,sed is going to be strongly Mac. 
Fve recently seen a few places like lawyers offices and 
psychiatry offices using .Macs, which is nice to see and 
it si lows a lot of faith that t here’s going to be a lot more 
progression towards the Mac, And in these smaller 
offices they don’t have a full time tech staff and the fact 
that they can manage iheir own systems and their own 
server 1 bodes well for A]>p]e 1 think. 

SR: 1 have a couple sentences that 1 want you to finish, 
ready? 

AK; Ready. 

SR: 1 wish Mac OS X Server had... 

AK: A heiicr interaciion between the configuration files 
and the GUI. Ed really love to see it’s configuration file 
and what the GUI is changing and where the File is 
located. 

SR: So almost if you had Server Admin open that had a 
drawer, would show you the configuration Hie and path, 
and highlight the section of the conOguraiion file when 
you would make adjustments in the GUI. 4'his of course 
for most services to start. 

AK: Right. 

SR: I wish Mac OS X had... 

AK: Ilmmmm. I find that moving between networks and 
environmeni.s i.s not as seamless as I’d like it to be. A 
belter awareness of its localitjo. Sometliing like 
Location Manager. NFS performance is something else 
that 1 am crying out for. The perfarmance from NFS is- 
I’d love to see it so much better than it is. A straight 


platforms. 

AK: Last question. And you will lx? starting out‘ database here 
as I diis is a question that 1 will ask all our guests in the 
future, what are your lop Fve favorite movies? Movies that 
you could watch over and over and tjver again. No order 
is necessary, just the top five. 

AK: (l.augh.s) ok, let me think....(long pause)...iliey 
would l>e: The Red Violin, The English Patient, 
Sideways, The Italian Job (1969 version), The Wild 
(Released April 2006!). 

SK: Andrina, lhanks very much for speaking with me today, 

AK: Thank you. 


Yill 


About The Author 

Sthoan R Regan is CfO of iTlnstrutiion.tom, which specializes ia Mck 
05 X traiaing aad consaiting. He speaks regofaHy to CEOs and CFOs 
oa how to control IT department spending, the myths surrouadiag 
cross-platform iategration, and the lonacy of expected lost revenee 
stemming from a cultwe bred to tolerate IT staff and operating system 
inadequacies as "normal". He seeks to change seK-fulfiUmg iT 
departments that breed complacency for their fobs and contempt for 
the end user, neither of which are conducive to business. 
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Introducing NeoSMART (Super Maximum-capacity Advanced Reliable Tape) - 


Maxell's latest technological innovation. 



With seven innovative advances, including an ultra-thin tape coating, nanometric metal particles, and superior servo-track writing, 
NeoSMART is expanding capacities from gigabytes to terabytes and beyond. Providing superior capacity, durability and reliability, NeoSMART is 

tire ultimate solution for the evernncreasing demands of data storage. Just look for the NeoSMART symbol 
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State Property 2 


Opening QuickTime Movies using Properties 


n the previous QuickTime Toolkit article (“State Property” in 
MacTech, November 2005), we learned how to work with the 
QuickTime properties functions introduced in QuickTime 6.4 
and considerably expanded in QuickTime 7. We saw how to get 
and set movie properties using those functions, and we saw how 
to install a property listener so that our applications can be 
informed about changes to some of those movie properties. 
Currently, only two small sets of movie properties are gettable or 
settable or listenable using those functions. These are a handful of 
visual properties (hue, saturation, brightness, and contrast) and a 
smaller handful of audio properties (gain, mute, and balance). So 
why is the header file Movies.h chock full of identifiers for other 
property classes and other property types within those classes? 


The answer is that those additional 
properties are intended for use by other 
functions, and in particular by the 
NewMovieFromPiroperties function, 
which was introduced in QuickTime 7. 
NewMovleFromProperties is intended 
as a replacement for die plethora of 
existing ''NewMovieFrom” functions, 
including 

NewMovie, NewMovieFromFile, 
NewMovieFromHandle, 
NewMovieFrojaDataRef, 
NewHovieFromStorageOffset, 
NewMovieFromDataFork, 
NewMovieFroniDataFork64, 
NewMovieFromScrap, and 
NewHovieFromUserProc. 


The basic idea is that we first specify an array of 
properties that we'd like our new movie to liave, and 
then we call NewMovieFromP roper ties. This allows 
us to open a movie that has exactly the properties we 
desire, without having to rely on QuickTime to establish 
some default set r)f properLies that we later need to 
override* It also allows us to specify properties that 
cannot be specified u.sing the existing hmetions. For 
instance, the constant pitch audio setting (whereby the 
audio pitch remains constant even when the playback 
rate of a movie increases or decreases, thus avoiding the 
infamous ‘‘chipmunk'' effect when fast-forwarding 
through a movie) must be set at the time a movie is 
created, and NewMovieFromProperties is the only 
movie-opening function that allow^s us to specify a 
setting for that property. 

In this article, we1i see how to work with 
NewMovieFromProperties. We’ll take a lc.x>k at the 
ctlasses of properties that we can pass to it and see how to 
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sec movie projx*nies not oilierwlse settable using the existing 
NewMovieFrom functions, lliis topic might seem vaguely 
familiar to ycju, as we U)uclied on a very similar 
programming model when investigating the 
initWilhAt tributes : error: method in Uie QTHovie 
cUlss in QTKit (see ‘^Baek to the Future, Pan Ift” in MacTech, 
July 200S). In fact, initWithAttribiites: error; 
internally calls NewMovleFromProperties, as you might 
easily have guesseef 

Input Properties 

Let's begin l>y taking a lotik at the declaration of 
NewMovieFrotnProperties, In the Movies.h file 
shipped with QuickTime 7, we see essentially this: 

OSStatus MevHovierronLProperties { 

ItemCount inputPropertyCount. 

QlNewMoviePropertyElement* inputProperties. 
ItemCount outputPropertyCoiLint. 

QTKewMoviePropertyElement * output PropertI.cis . 

Kovie. theMovle) : 

As you can see, ihis function rakes as input an array of 
QTNewHovieP r op e r tyEl nment structures 

Cinpu IP roper and the number of elements in 

that array (inputPropertyCount). i'hese properties 


descril>e liow to instantiate the movie. If successful, 
this function returns a QuickTime movie identifier in 
the location pointed to by the theMovie parameter. It 
may also return to the caller a different array of 
properties (out put Properties), which provide 
additional information about the newly-created movie. 
These output properties, for in.stance, may indicate 
whether a data reference i>a.ssed in the 
inputProperties array was changed during the 
process of opening the movie. (More on output 
proj>crties later) 

The QTNewMoviePropertyElement structuie is 
defined like this: 


struct QTNewHoviePropertyEleraent f 

QTPrQpertyCXass propClass; 

QTPropertylD propID; 

Eyt^Count propValii^Slr.e ■ 

QTProper-tyValuePtr propValueAddref 3 a: 

OSStatujs props tatus; 


The first tw(j fields of this structure are the class and 
tlie ID of a mtrvie [property; if you liave read ilie 
previous two Quickl'tme Toolkit articles, these items 
should be elear enouglr The third and fourth fields 
indicate the size and locatiun of tlie value of that 
property. 



Draw code 

You know you want to 


f -- 

[ objc instance/New 


[ /Get Class Name^ 

T 

[ objcjQQkUpClass J 


NULL(^ [ objc_msgSen 
— u ' u 


. -u-- . Q.. ^ 

[ /Set Instance id j NULL^^ 


• Edit while you net 9 One click Cocoa and Carbon application creation 9 Powerbil 
www.a n descotia .coni 

































For input prupcriies, the final field of the 
QTNewHovieP roper tyElement structure* 

propStatus* is set by NewMovieFromProperties 
to a status value that indicates whether tiie spctiried 
properly was successfully set on the new movie. In 
general, the value of this field will be set to 0 (noE rr). 
But occasionally a non-zero result will l>e returned in 
that field. For example* if you mistakenly pass in a 
data value that is not the size that QuickTime is 
expecting for the class and TD you specify* the value 
-2184 CkQTPropertyBadValueSizeErr) may be 
returned in that field. Similarly* if you specify a 
property that cannot be set* then the value -2191 
CkQTPropertyRoadOnlyErr) will l>e returned. 

The simplest possible way to call NewMovie 
FromPropertios is to pass in no input properties 
and to request no output properties* like this: 

etr = N^wMovieFcomProperties (0, NULl.. 0, NULL* 

&movie); 

This is effectively the same as calling NewMovie with 
its flags parameter set to 0 — not particularly useful* 
but sometimes necessary if you just want to create a 
new empty movie with all the default characlerisltcs, 
WeTe more likely to call NevHovieFromProperties 
passing in a properties array that at least includes a 
movie locafion and some additional properties. Let's see 
how to do that. 

Specifying a Movie Location 

The kx.'ation of a movie's data is specified by adding 
to the input properties array an element with the 
kQTPropertyClass_DataLocation class. Currently 
these property IDs are supported: 

enuxn ( 

kQTDataLocatiOTiPropertyID_DataRefereiice “ "dtef** 
kQTDfltaLoc at ionP rope i:tyID_CFSti:iiigNative Path 
= *cfnp * * 

kQTDataLocationPropertyID_CFStringPosixPath 
- -cfppv 

kQTDataLacationPropertyTn_CFStringHFSPath 
=*cfhp'* 

kQTDataLoc ati onPr oper ty I DHCP'S t tlngWindowaPa th 
= * cfwp *, 

kQTDataLocatlonPropartyID_CFURL “ 

kQTDa t aLocationP ro pe rtyID_QTDataHa ndier 
^*qtdh* * 

kOTDataT40catlonPropertyTD Scrap ^ *acrp*. 

kQTDataLocationProper tyI0_LegacyMovieRcfiou rceHandle 
^ 'rezh', 

kQTDataLocationPropartyID_MovieUserProc “ *uspf* 

kQTDataLocationPropen:yID_ResaurceFDrk 'rfrk', 
kQTDataLocationPropertylD^DataFork * ^d±rk' 

For example ’— starting with an easy case — we 
can open a new movie that uses data on the scrapbook 
Cor Cocoa pasteboard) by using the 
kQTDataLocationPropertyID_Sc rap ID* as 
shown in Listing 1. 


Listing 1: Loading a movie from the 
scrapbook/pasteboard 

QTNewMoviePropertyElement props[IJ ^ ilOll: 

Movie movie “ NULL; 

props [0] *pi-opGlas^ - kQTPropertyClass DataLocatlon: 
props [0] ,proprD ^ kQTDat3LocatlonPropertyID_Scrap: 
props(0l,ptopValaeSize = 0; 
props [0].propValueAddress ” NULL^ 

err “ NewMovieFromPropertiesd* props. 0. NULL, 
&movle): 

Notice that we do not need to assign any non-zero 
value to the propValunAddress field, since the 
property ID uniquely identifies the location of the 
movie data. Listing 1 provides a reasonable 
approximation tsf the existing NewMovieFromScrap 
function. 

Listing 2 shows a slightly more interesting 
example* which opens a movie specified by a URL* in 
this case a CFURL. 

Listing 2: Loading a movie from a URL 

QTNewHoviePropertyBlement propsUl (|0|) j 
Movie movie “ NULL: 

propsfOl,propClass “ kQTFropertyClasa_DataLocatlon: 
props 10],propID - kQTDataLocationPropertyID_CF0RL; 
props [O] ,propValiieSlze “ Bizeof (CFUELRef) : 
props [0],propValueAddress ” &cfurl: 

err “ NewKovieFrotnProperties (1, props. 0. NULL, 
&»ovie): 

And Listing 3 shows tlie most general case, where d^e 
movie data location is specified by a d:ita reference. In 
this case* we need to pass the address of a 
DataReferenceRecord, declared like dits: 

Btrudt DaraReferenceRecord i 

OSType dataRefType: 

Handle dataRef: 

D 


Listing 3: Loaduig a movie from a URL data 
reference 

QTNewMovleFropertyEl(^m€5nt props 111 “ [|0M: 
DataReferencGRecord dRefRoc; 

Movie movie = NULL: 

dRefEec . dataRef Type = URLDatallondlerSubTypc; 
dRefRec.dataRef “ uri: 

props to]-propClass - kQTPropertyClas6_DataLocatian: 
propBto]*propID = 

kQTDataLocatlonPropertyID^DatsReference: 
props[0],propValueSlze " eizeof(dRefRec): 
props [0] ,propValueAddres4? ” MRerRec : 

err ^ NevMovleFromPropertiesCl, props, 0, NULL, 
Amovie); 
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specifying Movie Properties 

So far, this should all be straightforward: for any 
particular movie data locator ID, we just need to set the 
p ropValueSize and propValueAddr ess fields 
appriipriaicly. There should be at most one data locator 
property in the array we pass to 
NewMovieFromProperties. But there can also be 
other kinds of properties, including movie 
insiartliation properties (whose class is 
kQTPropertyClas s_MovieInstantiation) and 
neuf movie properties (whose class is 
kQTPropertyClass_NewHovieProperty). 1 lere 
are the cunendy-defined movie instantiation input 
properties, which govern how QuickTime instantiates a 
movie: 

enam 1 

kQTMoviGiiistantiationPropertyIB_Don1;Re3QlveDataBofs 
= ‘ rdrn*, 

kQTMovi eInstantlationPr ope ttyID_Dont As kUn resoiv edDat 
aRefs taurn' , 

kQTMovielnsrant latloiiPropertylD^DontAutoAiternatee 

kQTMovlelnstaTit lation?ropattyID_DontUpdateForeHackPo 
inters ^ ‘fbpn'* 

kQTMovleInstantiationPropettyID_AsyncOK * 

'asok', 

kQTMovlelnstant iflt I onPtoper tylD^ldleliiiportOK - 
*imok *, 


kQTMovieInstanriatloiiPropertyTn_DontAutoLrpdateClock 
“ 'and' 

J : 


And here are the currently defined new movie 
properties, which provide additional settings for a new 
movie: 

anum I 

kQTNewMnviePropertylD^DefauitDataRef * "ddrf' , 
kQTNewMovlePropertylD_Active “ *acrv‘, 

kQTNGwMoviGPropertylD_DontInteractWithUser = 

' ifiLn’ 

1 : 

'Iliese two sets of properties tninror the newMovle 
flags speciRable as a parameter to the NewHovie and 
similar Functions: 

enum t 


newMovieActive 


1 

« 

0, 

newMovieDotitResolveDataRefs 

- 

1 

« 

1. 

n GwMoVie D onrAs kU n res o1vedDat aRef s 


1 

« 

2, 

oewMovieDontAutoAItemates 

- 

1 

« 


n evKo vieDontUpda t ©For eBa c kP oint e r s 


1 

« 

4, 

n ewMovieDontAutoUpd ateClock 

- 

1 

« 

5. 

n ewMovieAsyncOK 

= 

1 

« 

s. 

newMovieldlelmporcOK 

= 

1 

« 

10 

newMovleDontlnterac tWlthUser 

m 

1 

« 

11 


1 : 

For example, to open a movie specified by a UKL 
so that the movie data loads asynchronously and so 
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that liie ri;sulLing movie is active, we could execute the 
code in Listing 4. 

Listing 4: Loading a movie from a URL with 
additional properties 

QTNewMcjvlePropertyElement propslS] ^ [lOtl; 

DataReferenceRecord dRefRoc: 

Movie movie = NULL; 

Boolean isActive = true: 

Boolean iaAsync ** true; 
long nuin ^ 0: 

dRefRec.dataRefType = URLDataHandlerSubType: 
dRefReo.dataRef ” utlt 

props lOj ,propClass = kQTPropertyClaaa_DataLocation; 
props[0]-propID - 

kQTDataLoeationPropertylD^DataReference; 
props [ol • ptopValueSize = sisseof (dRefRec) ; 
props [0] propValueAddress ^ StdRefRec ; 
num^: 

propsLlJ‘ptopGlass * 
kQTPcopertyClas5_MovieInstantlation; 
props[Ij.ptopID “ 

kQTMovleIns tantiationP rope rtylD_AsyncOK; 
props[1]»propValueSize ^ sizeoftisAsync); 
props[1].propValueAddress “ ficisAsync: 
ruim++ ; 

props [2 J , propClass 

kQTPropertyClasS_NewMovieProperty: 
props[2l.propID “ kQTNewMovieProperiyID_Acrive: 
props [2] . propValueSlze sizeof (IsActlve) : 
props [2],prnpValueAddress * &lsActive: 

num'H-; 

err NewMovleFromPropert iea (nutn. props. 0. NULL. 
Siinovle) ; 

Output Properties 

A.S noted earlier, NewMovieFromProperties can 
also return a set of propenies to tlie caller, wliich indicate 
additional infbnnation alxiut the newly-ojx^ned movie. 
Currently there are two such output propertie-s: 

kQTHovl 0 SesourceLocatorPropertyII}_LegacyResia 

kQTMovleReBourceLocatorPropertyID_LegacyResNaroe 

Tliese indicate die re^source ID of the movie and tlie name of 
die movie resource. Tfie resource name Is generally not 
terribly useful, but the resource ID can be u-seful in 
determining wliedier die movie atom w^is loaded fnnii tlie 
file’s data fork (returned value is -1) or die lesource fork 
(neturned value Ls greater than 0), or whether iliere was no 
movie ak>in in the stc)rage container (retunietl value is 0). 

We can obtain an output property by passing in a 
second array of QTNewHoviePropertyElement 
structures, as shown in listing 5. 

Listing 5: Getting an output property 

QINewMoviePropertyElement props[3l = 1(0)1: 
QTNevHoviePropertyEletnent outFropfl[l] ^ (tOIJ: 

Movie movie ^ NULL: 

Bhoxt re^ID “ 0: 
long num = 0: 


// set-up of input propertitfs tunittcd 

out PropsfO],propGlass = 

kQTPropertyCiasS^^MovieReaourceLocaior ; 
outProps[Oj.propTD = 

kQTMovieReso urceLoea t or Proper tyID.Le gacyResID: 
OUtProps LD J , propValueSi;50 *“ s 1 zeof (resID) : 
outProps LOj *propValueAddres» " AtreslD; 

err “ NewMovieFroioProperties(num, props, 1, 
outProps, 

^movie) : 

On successful completion of this c:odc% the kx:al v;mable 
resID will contain the resource ID t)f the movie resource. 

Conclusion 

In this article, weVe learned how to use the 
NewMovieFromProperties function intrcxluced in 
QuickTime 7 as a replacement for the array of existing 
NewMovieFrom functions. We've .seen liow to specify the 
kx^tion of die movie data and how to set default properties 
on tlie new movie. WeVe also seen how to gel values of 
certiiin properties back fmm NewMovieFromProperties. 

In the next several articles, well continue 
invt:stigating NewMovieFromProperties, In particular, 
we'll cake a look at the propenies associated with the 
kQTPropertyClass_Context property class, which 
allows us lo set media context pmperties of a movie. We 
use tJiese pto|xri1ies to create movies iliai render into a 
visual context (such a.s an OpeiiGL lexlure buffer) or to a 
particular audio device. 
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Deconstructing RSS 2.0 


Understanding How RSS Feeds Work 


By Dave Woolridge 


If ycRiVe one of tlie millions of people who miiinisiin 
your own weblog, then oclds are, yoiiVe probal)ly already 
familiar with KSS or Aiom feeds since most blog tools 
include support for offering your blog as a syndicated 
feed, If you don't write a blog, tlien you’ve undoubtedly 
seen the RSS icon displayed online (see Fig^ire 1) or have 
teen invited by wel) sites to subscrite to iheii' free RSS 
feeds. In fact, it's such a hot technology these days liiai 
you would have had to have been living *’off the Grid" for 
the last few years to liave not lieard alxjut RSS. 

With aggressive spam filters making e-mail 
communication difficuk for even legitimate marketers and 
businesses, web feeds have become a safe and 
dependable metluKl for you to successfully cleliver news 
to your audience, as w^ell as allow tliird-parly sites to 
syndicate your teed conlem for expanded reach to new' 
viewers. Its a win-w'iti situation for eveiyone involved. 
Users can sul7scnte to only the feeds they wish lo receive 
and third-party sites are provided w'iih free content for 
their sites that ultimately drives additional traffic to your 
site via your feed’s links. 


RSS ■ XML 


Figure 1 p Typical RSS buttons seen on web sites and 
blogs, commonly referred to as ^chicklets" 

While the RSS and Atom formats are lK>lh tised 
lliroughoiit the Internet for content syndicalitm, this article 
will focus on the RSS 2.0 specification. With support for 
multimedia endosures and other miilti-pur|KJSe feiilures, 
RSS 2.0 is quickly tecoming one of tlie mcjsi popular 
flavors for content syndication, providing site twners with 
a powerful vehicle for delivering a lot more than jusi 
news. Have you evei' subscribed to a p<Kk'ast? Yup, ytju 
guessed it... porlcasts are RSS 2.0 feeds. 

How RSS Works 

Before we dive in, let's dispel the most common 
misconcejjtion alx)ut web feeds. While many people use 


the word “broadcast” to descril>e online content 
syndication, web feeds are nt)i transmitted like radio or 
television signals. They are not teamed or sent to 
subscribers. A web feed is nothing more than an XML 
doaiment that resides on a web server. This means that 
your news reader software or web browser is fetching the 
RSS feed from a specified URL, *f would do to 

access an I TIML w^eb page. The reader/brow.ser softw^are 
then parses (translates) that XML document, providing it 
lo you in a display format that’s easy to read. Wlicn using 
a news reader application (such as NetNewsWire or 
NewsFire) or an RSS-savvy browser (such as Safari or 
Kirefox), .sul7,scribing to an RSS feed is like adding a 
IxHjkmark to your favorites list. 1'he only difference is that 
an RSS feed w'ill get auiomaucally checked for new^ 
updates on a regular basis, which requires the 
rcatler/browser to go fetch the XML ckx’umcnt horn the 
le^ed’s URL at each timed interval. 

XML Syntax 

Since well be lakijig a look at the stiucture of an RSS 
Feed and die sfK.*cific functionality of each XML lag in die 
RSS specification, it s important to understand die basic 
syntax of XML (Kxlensible Markup Language). Like HTML 
c'ode, XML consists of tags such as: 

<tltle>Hy RSS Feed</title> 

Unlike HTML, which lielp,s define styles and 
formatting for text, XML lags striilly define llie meaning 
and context of information, keeping all of the text neatly 
organized widi tag names. You don't have to te a master 
of XML in order to write or modify your own RSS feecls, 
but there are a few' basic rules that you should keep in 
mind, 

• Every valid RSS feed needs to include <?xi]il 
version^"!.0” encoding="UTF-8"?> as the 
very first tag at the top of the document, UTF-8 is what 
most feeds use as the text entxxling and most RSS 
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parsers assume UTF-^ as the default if no encoding is 
specified, but if you need to use a different encoding 
for a special purpose, then change the enaxJing 
attribute accordingly. 

• Tile nesting order of XML tags is very important in 
order for your code to l>e valid For example, the 
following line is properly nested: 

<skipDayE>Cday>Sunday</d3y></skipDays> 

while the same line of code below' will cause enors 
since it contains invalid nesting: 

<skipDaysXday>Sunday</skipDays></day> 

• XML is case-sensitive, so <skipdays> is not the same as 
<skipDays>» While .some RSS readers and browsers 
may l>e smart cnougli to overlook case typos, you 
certainly w^ant to avoid any potential problems with 
your feed, so if youYe modifying your RSS code by 
hand in a text editor, make sure your lags conft>rm to 
the RSS 2.0 specification. 

• Be very careful when including HTML ctxle within 
XML. If you need to include HTML code within the title 
or descTiptitin tags of a new.s item, you need to either 
enclose all of the lexl within a CDATA block such as: 

<c}C!SCr(pt 3on><! tCl)ATA[My <b>Blg</b> Mewi;] ] > 
</dei3cript:lon> 

or convert all HTML brackets and sj^ecial cliaracters 
into XML-safe entities such as: 

<des<!ription>My &lt ;b6tgt : /btgt; 

/description> 

Reviewing an Example 

To get a feel for what we are talldng about here, let's 
take a ltx)k at an example RSS feed, RSS is short for 
'Itealty Simple Syndication/’ and as you'll see from the 
XMT. code in Listing I, the format really is quite simple 
ovcTall RSS 2.0 feeds can f>e saved with a file extensitm 
of either ,rss or .xmL Listing 1 shows an RSS feed that 
includes two items. 'ITie first one is a typical news item, 
while ihe second one eon tains a media enclosure, similar 
to what you would find in a podcast. 

Listing 1: All RSS 2.0 Feed Example 

<?xml version--1.0" eneodlng-"UTF-8-?> 

<risa verslon*-2.0^> 

<clmnnel> 

<title>SplderWorks News</title> 

<link>http://www.epiderworks.com/</link> 
<description>Quallty eBoek^ and Printed Books 
from Respected Authors at a Great 
Pricei</descriptlon> 

<1anguage>ens/lsngusge> 
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<copyright>Copyright 2005 SpiderWorks^ LLC. All 
rights reserved *</copyright> 

CmanaglngEdltor>news@spiderworks * coin< i managingEditor 

> 

CwebMaster5support@i3plderworks . tiom</WebMaster> 
<ratii>g> </t3tlng> 

<pubDate>Hon. 24 Oct 2005 05^53:07 GI1T<!/pubDate> 
<iastBuildDate>Mon, 17 Oct 2005 08:13:02 
GHT</lastBtiXdDate> 

<category 

domain='’http : //www. spiderworks .coiii">Booka</category> 
<docs>http: ! /blogs.law.harvard.edu/tech/ras </docs > 
<gGnerator>SpiderVorks Staff</generator> 

<skipDays><day>SuTjday</day></ skipDays> 
<skipHours><hcut>l4</hour></sklpHours> 

<ttl>30<tti> 

<cloud domain"'"http: / /www, spiderworks * com" 
port-"80" path“”/rpc‘* 

r e gi ste r P r o cedur e=r ssPl easeNot i f y " pr ot oc ol=" XML - 
RPC" /> 

<lniage> 

<title>SpiderWorks</tltle> 

<iirl>http : //www. spiderworks . com/swbadge . gif </url> 
<link>http://www.spiderworks.com/</link> 

<width>120</width> 

<helght>35</he±ght> 

<descriptlon>Qu.allty eBooks and Printed Books 
from Respected Authors at a Great 
Price! < /descr±ptioii> 

</ima ge > 

<te>LtInput> 

<title>Search SpiderWorks</title> 
<descrlption>Search the SplderWorka Web 
Sito</descriptlon> 

<naiue>q< /name> 

<link>http: //www . spiderworks, conr/search , pl</l lnk> 
</textInput> 

<tltle>SpiderWorks Releases Danny Goodman's New 
Dashboard Book</tJtle> 

<link>http://www,spiderworks,com/books/dashboard.pbp 
</link> 

<desGription>Vorid-renowned JavaScript and 
Dynamic HTML expert, Danny Goodman, shows you how 
to build rock-solid, professional Dashboard widgets 
for Mac OS X Tiger in his new book* Mac OS X 
Technology Guide, to Dashboard* Includes exclusive 
widget debugging tool. The Evaluator! Available as 
an eBook and printed edition at 
SpiderWorks.com</descrlption> 

<category 

dotnain="http : / / www* spiderworks * coni/topics / tiger . php" 
>Mac OS X Technology Guides</category> 

<sciurce 

url="http://feeds.feedburner.com/spiderworks">Spider 
WorkG</source> 

<autbor>Dave Wooldridge</autbor> 

<pubDate>Tue, 05 Jul 2005 2:37:01 GMT</pubDate> 

<coniTnents>http: //spiderworks . blogspot. com/2005/07 /da 
shbo ard_cQmment s * litml < / comment s> 

<guid 

.lsPGnnaI,lnk^"true*'>http : / /spiderworks. blogspot ,com/2 
005/07/dasbboa rd.html</guld2 
</item> 

<itera> 

<title>Spiderworks Interview with Ben 
Waldle</tltle> 

<link>http://www.spiderworks.com/books/automator.php 
</ilnk> 

<descriptlon>SpiderWorks recently sat down with 
author Ben Waldie to discuss his new book* Mac OS X 
Technology Guide to Automator. Listen to the full 
Interview online,</description> 


<enclosure 

url”''http: //www. spiderworks ,com/audio/waldie,iiip3" 
length='*243108" type*"audio/mpeg'“/> 

<category 

domain=”http I//www.spiderworks * com/topics/tiger.php" 
>Mac 03 X Technology Guides</category> 

<source 

url^^http://feeds.feedburner.com/apidarworks">Spider 
Worka</aource> 

^author^Dave WooldrldgeC/authQr> 

<pubDate>Hon, 02 May 2005 0:00:01 GMT</pubDate> 
<comments>http://spiderworks,blogspot,com/2005/05/au 
toTiiator_coinments . html</comments> 

<guid 

lsPermaLink="true">http://spiderworks.blogspot,com/2 
005/05/automator.html</guid> 

</±tem> 

</channel> 

</rss> 

At first gl^ince, Listing 1 l<K)k.s like a typical XML 
document, l)ut what sets it apart as RSS is the way the 
XML data is stnjctured. The root element is, of course, the 
rss tag. Nested within that tag Ls the channel tag. It's 
within the channel tag that the meat of tiie document is 
stored. Figure 2 breaks down the main ingredients of this 
RSS example into groups, providing you with an easy way 
to visualize the XML code in Listing 1. 


RSS 

CHANNEL 


CHANNEL 
ELEMENTS > 



•r m' 

ITEM 1 




ITEM I 


Figure 2. The RSS example broken down into basic 
groups of elements- 

Tlie groups within the channel tag consi.st of two 
groups of dam: (1) channel elements that desc ribe details 
aboili the RSS feed itself, and (2) items that liold your 
news stories, podcast audio tracks, etc. Wliile Listing 1 
and Figure 2 oniy include two items for example 
purposes, you can add as many items as you want to your 
own RSS feed. 

Defining Your RSS Feed 

As shown in Figujre 2, before your actual news items are 
listed, your XML needs to include some liasic information 
about the RSS feed itself. These tags are called channel 
elemenLs and include importajit inlbmiation like the title of 
your feed, die content’s copyriglit, the date the feed was last 
updated, etc. Only a few of these elements are reejuired, but 
the more information you provide, tlie more efficiently the 
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receiving RSJ> iie-aders (kriown as aggii^gator?>) can lumdlc and 
process your data. For example, including optional tags like 
lastBuildDate and ttl can help relieve the server load 
from your feed lx.nng requested unnecessarily since those 
tags specify when the feed was last updated and how long 
Lite data should K* cached (stored temporarily) before 
refresliiiig witli a new HITP request of tlie feed, 

Wliile all of the channel elements are defined here, 
plea.se refer to the ctxle examples Ln Listing 1 for the 
projK-T XML syntax of Lficse tags. 

title 

REQUIRED. The name of your feed, which is usually 
the same name of your blog or web site tlmt\s related to 
your feed. 

link 

REQUIRED. I’he URL of your blog or web site (not the 
URL of your feed). 

description 

REQUIRFD, A very brief phrase or sentence that 
dcscril)cs your feed's overall conienL 

language 

Optional. The language that the feed is written in. 
For list of possible language codes, please refer lOi 
http://biogs.law.harvard.edu/tech/stories/stQrvReadert15 

copyright 

Optional, 'fhe copyright notice for the feed’s content. 
Do not use ihe ac?Uial cx>pyright s^anbol since that special 
cliaracter imiy not display proix.Tly in RSS readers. 

raanagingEditor 

Optional. Tlie e-mail address of the editor of the 
content, llus is not necessarily die audior of the content, 
since the content may have come from multiple sources, 
but Uiis is the person %v[io is managing the feed. 

WebMaster 

Optional. The e-mait addres.s of the webmaster who 
oversees all technical issues related to die feed. 

rating 

0|>tional. Tlic PICS rating of the feed, which fielps 
adults control what online content is accessible by 
children. Thi.s tag is rarely used, but for more information 
on PICS, please visit: httD://wwvv.vv3.Qrg/P]CS/ 

pubDate 

Optional. The publication date of the feed, which states 
the earliest cLite tliat die content can be publicly displayed. 
Most aggregators ignore tills tag and instead focus on The 
la.stBuildDaLe Lag. TIte dite should l>e formatted to 
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conform to K.FC 822^ which can be found at: 

http://85Q>web.cmu,edu/rfc/rfc822>html 

lastBuildDate 

Optional. The date LlmL the feed wa,s Iasi updated, 
lliis LS often one of tlie first tags that aggregators check to 
see if any new content was been added or updated since 
the last time the feed was requested. Like pubDnte, this 
tag's date should be formatted to conform to RFC 822. 

category 

OptionaL If your blog or web site organizes blog 
entries and articles into specific categories, then tlhs tag 
may help aggregators to categorize items accordingly. 
Unfortunately, Uiere is no standard cataloging system, so 
often this tag only proves useful for your own site needs. 
The domain anribute typically refers to a LIRL for that 
category online, but if your site does not include unique 
web pages for each category, then you may want to just 
link to your home page. 

docs 

OptionaL 'Lhis tag should link to the official RSS 
specification online. As an RSS 2.0 feed, this tag shoiild 
point to: http:/yblogs.law.harvard.edu/tech/rs5 

generator 

Optional, ff you used feed generator software to 
create your feed, then the application would give itself 
credit in this tag. For example, if you used FeedForAll to 
generate your feed, then tliis tag may read; 

< genera to r>F53^dForAl 1</genera tor> 

skipDays 

Optional, lhis tag infbrnis aggregators that the feed 
should not he read on certain days. Within the skipDays 
tag is a nested day sub-element, so that you can include 
more than one clay within skipDays. Acceptable day 
values are: Monday, Tuesday, Wednesday, Thursday, 
Friday, Saturday, ot Sunday. For example, to list both 
Sunday and Monday as days to skip, you would use the 
following XML syntax: 

<skipDay3><day>Sunday< / dayXday >Monday^ / dayX/sklpDa 
ys> 

skipHours 

Optional, 'lhis tag inhirms aggregators that the feed 
should not be reiicl during certain hours. The skipHours 
tag syntax works exactly like tlie skipDays tag, except tliat 
the sub-element is hour instead of day. An acceptable 
hour value is any whole number between 0 and 23. Like 
skipDays and its day sub-element, skipHours can 
include multiple hour sub-elements. 


ttl 

OptionaL lliis tag represents the ‘‘time to live” wiih 
the value being in minutes, h tells aggregators liow long 
the feed conLenL should l)e cached on their end before 
refreshing with a new HTTP request of the Feed. For 
example, if you use 60 a.s ihe value, then aggregators will 
know that they need to wait 60 minutes before requesting 
a fresh copy of the feed, Tliis can help alleviate some of 
your server load since it will decrease the numlier of 
redundant feed requests. 

cloud 

Optional. This is probably the most rarely used and 
most confusing tag in the RSS 2,0 specification. Many 
developers who encounter this tag either don’t 
understand how it works or have m)i figured out how 
to best utilize it. This tag represents a lightw^eight 
publish and subscribe feature Chat includes Five 
essential attributes: domain, pom, path, 

reglstorProcedure, and protocol. It is a way 
for RSS to leverage the power of web services like 
SOAP or XMI-RPC to conserve seiwer bandwidth, 
allowing aggregators to regisler to be automatically 
notified of any u[idates made to the feed. If you're not 
using SOAP or XML-RFC web services on your server, 
then you won’t have a need for this lag. For more 
information on using SOAP with the optional cloud 
tag, visit: htt[>://bioas.law.harvard.edu/tech/5oapMeetsRss 

iiiiage 

Oplional. You may have noticed that some 
aggregators display a logo or badge from the feed they 
are displaying. They get this data from the image 
element, wliidi includes six sub-elements: title, url, 
link, description, width, and height. For 
example, if you publish a sports news RSS feed called 
“Primo Sports Plus” which has its own unique logo, you 
can supply aggregators with that logo lo help bmnd your 
syndicated crontent There's no guarantee that aggregators 
will use tile logo, but the extra marketing potential makes 
it worth including, title represents the ALT tag if the 
image is rendered in HTML and link represents the URL 
of your site if .someone clicks on the image. The url 
attribute should be the direct LIRL to the actual image file 
itself. The image’s description value is usually the 
same as your feed’s description tag. Its important to 
note that the maximum image width value is 144 
(defaults to 88 if unspecilied) and the maximum image 
height value is 400 (defaulLs to 31 H unspecified). See 
Listing 1 for the XML code syntax of the image tag and 
its nested sub-elements. 

textinput 

Optional. This rarely used tag is ignored by most 
aggregators. It provides a way for aggregators lo submit a 
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st.*arch (if your site has a search engine) or submit user 
comments (if your blog accepts user input). If you decide 
to include this tag in your feed, it requires four sub- 
elements: title, description, name, and link, 
title is the name of the submit button for your text 
input box. description provides user instructions for 
the text input f>ox. name is the form name of the text 
input lx)x. link is the URL of your server-side .scTipl 
(such as FHP or Per!) that should pr<x:ess these text input 
submissions. See Listing 1 for die XML code syntax of the 
text Input tag and its nested sub-elements. 

The Anatomy of RSS Feed Items 

After youVe defined your channel elements within tlie 
channel tag, IPs now time to add your acaial content 
items. These are tlie items tliat are displayed by aggregators 
as news stories, blog entries, podcast items, etc. (depending 
on what content you wish to include in your (cod). Each 
item is encapsulated in its own item tag (that is nested 
within the channel tag below the channel elements). See 
listing 1 for the XML exxie syntax of the item tag and its 
nested sub-elements. The suh^elcments Uiat describe an 
item's content are defined here. 

While most feed items include a link back to die full 
online version of the article or blog entry, a lecd item 
does not retjuire a link if you wish to include all of the 
content in its description sub-elemenL In fact, none of 
the item sub-elements are required as long as you 
include at least the item's title or description. 

title 

Optional, 'fhis is the title of the item. Altliough its 
optional, most aggregators look for this item sub-element, 
so its highly recommended to include it. 

link 

Optional. This is the URL to the web page version of 
the item on your web site or bk>g. 

description 

Optional. *lhLs is the descripiJon of die item. For news 
stories and blog entnes, it’s your elioice to indude the entire 
text or only a summary. If you only include a summary, tht!n 
be sure to also include the link sulx-*iement in your item, 
so that users am ciick-through to your site to read the entire 
story. For pcxlcxusls, the description sul>element usually 
holds text infomiation about the song track and anist 
Altliough it's optional, most aggregators l(X)k for ifiLs item 
sub-element, so its highly reaiminended to include it. 

enclosure 

Optional Hiis sulvelement defines a multimedia file. If 
your feed Ls a podcast, dien the enclosure sub-element of 
each item would identify die related audio file. It requires 
three attributes: url, length, and type. The url attribute 


should lx: die direct URL to die actual media file itself. The 
vaJue of length should be the file size of the media object 
in bytes. Ihe value of type siiould refer to die media file's 
MIME type. See Listing 1 for the XML code syntax of the 
enclosure suf>element and its atiribtites. 

category 

Optional Tills su)>element works exactly like the 
cliannels category tag, except that it defines a unique 
category for the individual item. Like the charmers 
category tag, there is no standard cataloging system, so 
often this tag only proves useful for your own site needs. 

source 

Optional, 'this .should name the source of the item's 
content if you are not the original autlior. For example, if 
the content i.s from MacTech's RSS feed, you would list 
“MacTech” as the source value and the URL for 
MacTech's RSS feed as the value of the url attribute. 

author 

Optional Ihe e-mail address of the author of the 
item's content. For exainple, if die source is credited to 
MacTech's RSS feed and David Sobsey Is die author of the 
piece, tlien list David Sobsey's e-mail address as the value 
of this sub-elemeni. 

pubDate 

Optional. Hiis is the piiblit'iitinn diitc of the item, like the 
channel's pubDate and lastBuildDate tags, this sub¬ 
element's date should Ix^ fomiiitled to conform to RFC 822. 

comments 

Optional This Ls the URL for the item's related web 
page of user comments. 1'his sub-element is usually only 
relevant for blogs that allows wcli-based user comments. 

guid 

Optional. This is an interesting sul>clement that is 
used as a unic|ue tdentifier for the item. I'here i.s no set 
cronvention for how this sub-eletnent should be used, l)ut 
most aggregators expect it to be a imit[ue URL .string that 
no other kern am have, making it a valid item ID. For 
news .stories and blog entries, this works great since they 
would have their own unique URLs, lull if the item's URL 
is referred to more rlian once in your feed, dien it cannot 
be used as the unique identifier here. For a unique URL 
that will alw^ays lye available for viewing online, you 
shouid include the isPermaLink^^true” attribute. 

Moving Forward 

Now tliat youVe stepped din>ugh the entire ESS 2.0 
sptx'ific^uion, you're ready to put ESS to good use. If you're 
only interested in building your own RSS feeiis, then clieck 
out tlie Resources section of (his article for links to Mac- 


22 December • 2005 


WWW.MACTECM.COM 







v^jATnternSiofwUnc. iFted it o mg]il«r*d tiodvmaric dt Appb Computir, Inc, 



iPod' OUTSPOKEN. 


JBL ON STAGE ; SHARE MUSIC OUT LOUD WITH THIS HIGH-PERFORMANCE SOUND SYSTEM FOR YOUR MP3 PLAYER. 


WWWJBl.COM/JBlONSTAGE 














compalihle Iced geiiemtor applications that can help 
streamline the creation process. If you're coinfortaljlc 
woriting with XML, you can ubay use a standard text editoi- 
like BBEdit fhttp://vvww.barefaones^com or ;in XML editor like 
<oXygen/> ( http://www.QXVQenxml.CQm/) to roll your own RSS 
code, 'lb ensure xhin your feed adlicres to tlie RSS 
specrifiailion and does not include any errors, always test 
your feed with one of the many online validators (see llic 
Resources section for some helpful URLs), 

If you're interested in parsing RSS in your own sof^vtire 
projects or syndicating iliird-party feeds on your web site, I he 
Resources seaion also includes links to a few of die mast 
popular RSS piirsers for various programming languages. 
When developing your own RSS-savvy application or well 
site, it's important to assume that all RSS feeds are invalid until 
proven otherwusc, IVx.-ausc many of die feeds out diere are 
hand-coded, diey often contain the wrong text enctxling 
atuibute in the xml tag and/or just b^id XMl., sti it's a g^xx! 
ideji to include a lot of error liandling in your own parsing 
ccxle tti safeguard your users from problems. Defensive 
programming is definitely the name of the g^mie here. It's tilso 
recommended to support caching in ytjur RSS applicatioas. If 
third-parties are kind enough to offer you free cxintent for 
syndiciilion, lie consideiate of their .server hvndwidth by 
caching the feed content temporarily on your end and only 
retrieving a fresh feed ai limed intervals. 

For those of you wlio want more out of RSS, the 2.0 
specification allows you to extend RSS widi naiiicspacc- 
dehned modules. If yt3u're not familiar widi namespaces, diey 
art.^ part of die XML sfx.“ciIicalion that RSS 2.0 su]>ports a.s an 
ea.sy way to extend the feed format for aistom puqiost?s. For 
mote infbmiation on using namespaces to extend RSS 2.0, 
visit: http://www.reallysimplesyndicationxom/howToExtendRss 

And Iasi, but not least,,, once you have your own RSS 
feed available on your site, it's easy enough to add a link 
to it on your home page using one of the popular 
*‘chicklct" buttons showm in Figure 1. but how do you get 
Safari and la refox to automatically recognize your feed 
(see Figure 5) with that dynamic feed icon in the location 
bar and slatu,s bar respectively? 

I http://ebutterny.conn/ 

^_, 

Q I 

Figure 3. Dynamic feed icons in Safari and Firefox. 

The answer is actually quite simple, requiring only a 
single line of HTML code. Nested witliin the head lag of 
your web pages, add the following meta tag with the 
href attribute set as the direct URL to your RSS feed: 

<link rel“**alterr!ate" type’=”appllcatlon/tBS+xml** 
tltle“”RSS'' p: / /yoursite. tom/fesd . 

So what are you wmting for? Now tiiat you've gained 
some insight on how RSS 2.0 works, start taking advaniagc of 


one of the hottest new Internet technologies that can greatly 
incTease exposure for your pRxiucls and services, and drive 
additional traffic to your web site or blog. 

Resources 

Tfic following list is by no means comprehensive, but 
should serve as a good starting point for learning more 
about RSS 2.0 online 

RSS Readers/Browsers for Mac OS X 

NetNewsWire: httD://ranchero.com/netnewswire/ 

Radio Itscriand: http://radio.userland.com/ 

New.sFire; httD://www.newsfirerss.com/ 

Apple Safari: http://www.aoDle.com/macosx/features/safari/ 
Firefox: http://www.Qetfirefox.com/ 

RSS Feed Generators 

FeedForAll: http://www.fecdforall.com/ 

ListGarden: htt p://softwaregarden.com/products/listaarden/ 
pReSS; http://www.mizoq.CQm/Droductinfo/Dress/ 
OrangeBo.'c: http://www.globalsyndication.com/oranQebox- 
fof-madntosh 

Feeder: http://www.reinvcntedsoftware.com/feeder/ 

Online RSS Validators 

Userland Validator: http://rss.scriptinQ.com/ 

Feed Validator: httD://teedvalidator.ora/ 

RSS Parsers 

MagpieRSS for PI IF: httD://maQoierss.sQurceforQe.net/ 
CaRP for PHP: http://www.Qeckotribe.com/rss/c8rp/ 
Universal Feed Parser for PyUnm: http://fcedpar5er.orq/ 
R.SS Cla.s.s for Ccx’oa: httD://ranchero.com/cocoa/rss/ 
WSL-Feed for REALba.siC; 

http://www.ebutterfly.com/rb/websen/ices.asp 

Documentation 

RSS 2.0 Specification: http://b log s.law.harvard.edu/tech/rss 

Books 

Oa’eloping Feeds tvilh RSS and Atom by Ben 
Hammer-sley (O’Reilly): 
htt p :/ /www.oreilly.com/cataloQ/deveoDrssatom/ 

Beginning RSS and Atom Programming by Danny 
Ayers and Andrew Watt (Wrox): 
http://www.wrox.com/remtitle.cgi?isbn-^0764579169 
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Nagios on os X, Part 1 

INSTALLING AND SEITING UP ONE OF THE 
BEST NET MONITORING TOOLS AROUND 

I f you read my website, httpy/w/'ww.bynkii.com/, you may know 
I have talked about installing Nagios in the past. For a while now" 

I’ve wanted to write an updated, in-depth piece on this subject, 
and felt now was time to do so, and of course, only in MacTech! I’ve 
managed to simplify the install quite a bit, thanks to the hard work 
of the folks at DarwinPorts, http://darwinports.org. 


Welcome 

make installing and ccinfigtiring software easier If you 
compile and tnsiall open source software manually, 
you have to llguie out all the various dependencies 
and configuration issues yourselh This is not hard per 
se, hut it is tedious, l^orls managers, like DarwiiiPorLs 
manage this for yoiL If the l)am1nPorts repository lias 
the software you want, you install it, and it handles all 
the dependencies for you, Wliile, like everything else, 
there is any number of religious wars about ptirls 
systems, I like DarwinPorts, because it does the job 
well tor me, If you like Fink better, great! They're both 
really good systems. 

To avoid modifying Apple-supplied directories, 
I) a rw^ i n Port s I iv es i n / o p t /1 o c a 1 / . I f yo u i n sta 11 on 
Mac OS X Server, then youll already have /opt: its 
where Apache2 is installed. The advantage to this is 
that it makes uninstalling DarwinPorts dead simple. 
Remove /opt/local and all its contents, and 
DarwinPorts is gone. 

Since Darw^inJ^ofts dcx^sn'l have a NagitTS port, we can’t 
just use it for the full install, but we can use it, and some 
other UK>ls for the support libmries and applications Nagios 
needs. However, the first thing we have to do Ls install 
Darw'inPorts itself. Tlie easic^st way to do this Ls to get the 
disk image witli die installer from DarwinPorts, aimently at 
http://da™nports.org/dQwntoad5/DarwinPdrts- 1 . 1 .dmo . Download 
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'Hits article is going to have a few sectkms. First, 
wee'll get DarwinPorts instaUed and cunfigured. Then 
well use it to install the backend components Nagios 
needs. Third, well do the actual Nagios insiallaiion, 
and the plugin insiallaiion. Then well go over some 
of ihe basics oi' configuring Nagios. Note that this 
applies to the current version, wfiicli (S T2. Version 
2.0 is in final beta, but I prefer U) wail until that's 
done tx!r<)re installing it on production systems 

We should also talk a bit alxHii what Nagios Ls. 
Nagios is a network monitoring UxjI, It allows you to 
moniicjr services mnning on various hosts on your 
network. For example, you can monitt^r your switches 
to ensure they^re working, or you can monitor various 
critical .server prtjcesses on an Xseive, like the KfK.' 
f>nx:ess, AIT prcK^eSvSes, etc. You can, with various 
plugins from the Nagios Exchange site, at 
httD://www.naQiQsexchanQe.QrQ/ monitor internal counters 
on Windows servers too. If you Ye skilled with Perl, or 
any one of dozen.s of programming languages, you 
am write your own plugins. 

Darwinports 

DarA\anPorts, like Fink, or any other of a 
dt>xen ports inanagement systems is a way to 


















Lhc disk image, ami am the iastaller. Once yuLi’ru dt>nc 
witli iJuu, weVe g<>ing to l>e doing the rest of our work in 
lemiinal. 

To make life simpler, weTe going to set up a 
.profile in our home directory that will make using 
DarwinPorts easier While you don't have to do this, if 
you have multiple versions of software installed in 
varitHis platres, a .profile file will make your life a lot 
simpler My ,profile is a hit nsimplistic, but it works for 
my needs* In any text editor that wii! allow you to 
create .Hies, (pico, vi, emacs, Text Wrangler, 
SubEthaEdit, BBEdit, they're all good) create a file with 
the following entries, and save it in the root of your 
home directory as .profile: 

PATH-"/bin: /sbin: /use/bin: /usr/sbiri: /tjur/local / share 
/aclocal:/opt/local:/opt/local/bln:/opt/local/3 lb:/o 
pt/locsi/sbin" 

export PATH 

PKG_COtjPTG_PATtl“" / opt/local / lib / pkftconf i g,” 
export PKa_GONFIQ_PATH 

!lANPATH="/usr/share/man / i / ii.^r/XI1 Rb/tnan / : /opi / local/ 

share/man" 

export MAHPATH 

TNFOPATH-"/apt/local/share/info" 

The path statement ensures that when you enter a 
command, that the /opt/local tree is used 
automatically* It also leaves die standard paths for 
/bln, /shin, /usr/bin, /usr/sbin, etc* Tlie 
PKG_CONFIG_PATH is used to ensure that software 
you install under your login can find pkg-config, a tool 
u*sed lo make compiling libraries and apfiliculions 
easier* Tlie MANPATH statement makes finding man 
pages in the /opt/local/ tree easier The INFOPA'l'H 
variable is used by things like gettext, which figures 
into a lot of open source packages. If you already have 
your own .profile, then just add the /opt/local 
information if you wish. I rely heavily on DarwinPorts, 
so for me, having this .profile setup is a real timesaver. 
If you don't use DarwinPorts a lot, you may not wish to 
modify your .profile. 

So, once youYe done setting up, (or not) your .profile, 
weVe ready to go. If you did modify your .profile from 
within the 'lerminah you'll want to read dun file st) your 
environment Is *set tip. Just mn 

source “/.profile 

to *sel up your environment with die new information 
from .profile. Now we need to make sure DarwinPorts is 
up to date. To do this, run: 

sudo pert selfupdatc! 


and wait a few minutes. If there is any uixialing to do, 
you'll see some short status messages on the screen, and if 
all goes well, you'll get the "selfupdale donel" me.s*sage, 
and you're set* If you want to see ali the siaUis message.s 
for a sclfupdate, then nm: 

atjdo port d self update 

which enables debug mode for that command, youll get 
all the status tnessages. Below, I have the two screenshots 
for die same command on an updated .sysiem to give you 
an idea of the difference the -cl makes. 




I tend to only use the -d option if Fm Iraving 
problems, so I can better see where the problem is 
occurring. T like lo run the selfupdate option at the 
beginning of any install session, so I know Fni starting 
with die most current version of DarwinPorts. 

Once that's done, we install the various 
background libraries that Nagios needs using 
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DiiminPort'i and ihe install switch: 

sudo port install ^lib 
stido port Install libpng 
stido port install jpag 
sudo port install gd2 

Once all of those arc done, congrats, you've installed 
the sypptiH lihmrics for Nagios. Note that there are tons 
of ports in DarwinPorts, so tliis is only the barest smidgen 
of what you can get with DarwinPorts. 

We'll need to install at least one paniciilar Perl 
package for Nagios, namely NetiiSWMP. To do this, run: 

bu6o epan -1 Net :: SNMP 

If youVe never run epan before, you 11 have to nin 
tlirough sorne configuration steps first. TlicyVe pretty easy 
to follow, and if you're unsure of what to do in a given 
step, take tlie defaults. There's even an option to let epan 
try' to autoconfigure itself. 1 do it manually, but if 
autoconfigure works for you, so mucli the better. Using 
epan is much like using DarwinPorts, only just for Perl. 
If you're trying to install a Perl module thai has 
dependencies that you don't have installed, epan will 
prompt you U> install those as welk (If youVe only ever 
hear horror stories alx)ut downloading and installing 
open .source software. Pm here lo tell you that thanks to 
a lor of hard work by not a lot of people, that process has 
gotten much easier, and thanks to tools like epan and 
OarwinPorts, should no longer be thought of as scary to 
the uninitiated.) 

Installing Nagios 

Now that we have tlic support Itbniries installed, it's 
time to set up for Nagios. We'll need to creitte tfie dirc'i'tory^ 
that Nagios lives in, Aisr/local/Nagios. Next we have to 
create the users and groups that Nagios will use. (Security 
note: Ail of tliis assumes that you have a proper Hrewall 
and other protective measures in place. I would highly 
recommend that you don't install Nagios on a sy.stem 
directly exposed to the public Internet. A lot of liie 
protocols that Nagios use.s, like SNMP v2c are not 
encrypted f>r terribly secure, and having a Nagios box 
exposed to the public Internet will potentially cTeaitr real 
problems for you. ) 

Yoiril need to create at least a Nagios user and a 
Nagir>s group. Note that the nagios user does not need 
a login shell, just that the account works. Regardless of 
how you create the nagios user account, (System 
Preferences, Nellnfo Manager, Workgroup Manager, 
comniand line), you want to make it a local machine 
account only, and you want to set I lie login shell to 
/us r/bin/false. DonT give the account a 
pas.sword, You'll also need to create a nagios grouf). 
The Nagios group need.s two members, nagios and 
ww'w. (Adding www' to the nagios group makes setting 


up the integration betw^een Apache and Nagios much 
easier.) Once you've created the user and group for 
Nagios, then we're ready to download the Nagios 
.source code files. 

Go to the Nagios download site, http://www.naaios.Qra/ 
down load/ , and downU>ad the 1.2 version of the Nagios 
rarball, and the most recent version of the Nagios plugin 
tarball, 1.4.2 as of this writing. Save them both to 
whereever you want, 1 ususally save them to my desktop. 
Lln^.ip and untar the Nagios source code files. In the 
Terminal, cd to the nagios-1.2 direcaory. The first thing 
we have to do is run the configure utility so that we can 
compile and build the code correctly. As we're using 
some non-standard (for Nagios) library IcK^ations, we'll 
need to tell it where to find things. We also need tell 
Nagios where its own base directory is going to be, 
W'here the CGI directory it will use is going to fje, and 
where the base w^eb root directory it's going to use is. For 
this article, Pm using: 

./configure itflthgd llb^/opt/local /lib ^ith-gd- 
inc=/opt/local/incliidG — p ref I x*^/us r/local/nagios — 
with-cgiurl—/cgi-bln -with htmlurT”/ 

Make sure you don't have any spaces between the = 
and the leading / of the paths in the configure command, 
and let it rip. When you get done, you should not have 
seen any warning s or errons during the configure, and 
you should see a slants .screen like the one below: 



You'll want to save tliis screen .somewhere, in case you 
aren't sure where tilings are. With this .selling, Nagios is going 
to use the defiiults for ihings, .so we'U liave to change a few 
Things. Tina, it a.ssume.s tliat you're going to have all your web 
files onginating fiom /nagios in the URLs. We’ll fix tliat later. 
line egi-bin direcrtiry is the system default one, or 
/Ubrary/WebServcT/CGI-Executables, lliat we’U leave alone. 
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Now for all Mac experts! 

See the new MacTech Magazine 


Are you a power user? Like getting under the 
hood? Join the crowd. Find out what's causing 
all the buzz in the technical community. Check 
out RISK FREE the new MacTech: Now for all 
techs! 


The NEW MacTech Magazine is for anyone 
that wants to know what's under the hood. 
Whether a power user, hobbyist, IT Pro, or 
consultant MacTech has something to 
offer you. 


As a 20 year old publication, the All-New 
MacTech has been featuring an improved 
design and a greatly expanded editorial focus. 
Each and every month in MacTech you'll find 
in-depth coverage and how-to articles. Unlike 
many magazines that tell you what you can do, 
MacTech shows you howto make the most of 
your Mac experience. 


MacTech is already read every month by 
tens of thousands of readers, from power 
users to IT Pros to developers. They 
represent the very heart and soul of the 
Macintosh technical community. Join the 
most influential part of the community, and 
sign up for MacTech today! 


Be the one with all the answers. Make your Mac fly. Get under the hood. 


For a one year subscription visit: 

store.mactech.com/riskfree 







A,s,suminj^ your configure went okay, weVe going to 
njn the various Nagios make and in.stall commandsi 

make all 

If make all completes successfully, you’ll see a status 
screen like the one Ix^low. WeVe going to run the other 
make commands witli the exception of make install-init. 
since Mac OS X doesn't handle startup items like that, 
and we’ll want to test a bit before we make Nagios a 
startup item* 
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Figure 4; Completed make all screen 


sudcj make install 


If the make install goes well, yoifll get another status 
screen telling you srx 

sudo make inistaii -cairimaadmode 


’this command -sets up the exiemal command dimctoiy 
for you. important if you want to extend Nagios l>eyond the 
basics 


aydo make install-conflg 

This sets up the sample configuration files, which 
well go into later. Next is to configure and install the 
plugins. As with Nagios. unzip and untar the source 
files for the Nagios plugins. Change directory into the 
nagios-plugins directory and run ./configure* If 
there are no errors, run make, then sudo make 
install, 


Initial Post - Install Setup 

So Nagios is insuilled, the plugins are installed, we 
just Stan and go. right? Weil, not sso fast. First, we have to 
make sure that the web server side c^f tilings Ls set, since 
Nagios uses a web interface to show you what its 
monitoring. If you installed Nagios on Mac OS X Server, 
then you just use Server Admin to point die web server 
root at /usr/locaiynagios/share. You'll want to make sure 
you have CGI Execution enabled for the site, and that you 
have the necessaiy Apache modules enal>lcd Lo allow you 
CO run Perl and other language CGIs on the site. If you are 
using Mac OS X inste'ad of Mac OS X Server. you1l have 
to edit tlie necessary Apache config files by hand to do 
this. Oh yes. make sure that evil Performance Cache is 
turned off. 

Next. we copy the Nagios CGIs into 
/Library/WebServer/CGl-Execrula[>les/, The CGIs can lie 
found in /usr/ltx.’al/nagkxs/sbin* You want to make sure 
that at least die giouj^ for the CGIs is .set to www. and that 
the permissions are set so that tlie tjwncr and group can 
execiiie. (77/ leatfe ext^atlahfe rights Hp to }four 

particular needs and security posture). 

The next step is to ensure dial Nagios knows where 
its various web files really are. To do this, we want to 
open up side.hiiiil in /usr/local/nagios/share. and m^ike 
sure that all the references to CGIs look like tliis: 
href^"/cgi-bln/statuswrl. cgl If they do. then 
you Ye all set Uiere. 

If you've got everything pointed riglit, then we can 
test the basic operation, aka "can we ,see the Nagios Home 
Page". Just point your browser at the Nagios URL. and if 
it s all set up correctly, you'll see; 



Figure 5: The Nagios Home Page 


Note that nothing wtjrks yet. and in fact, the 
Nagios process isn^t even ninning. But at least we 
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know it can see the home page. So that's something. 
Next we want to make sure tliai just anyone cannot 
see all the information that Nagios can provide. If 
nothing else, you don't want the entire world, or even 
your entire company, getting detailed inh3rrnalion on 
your servers* 

There are a lot of ways to set up access control to 
web sites* rtri covering t^ne liere, namely using Jilaccess 
files. To do this, we're going to make a couple of 
changes to hrtpd.conf, and set up a ,htaccess File for 
locking down access. 

rittpd*conf chaageij: 

Note:Tbi}; a fairly simple way to set this ufx There are 
other ways to do the same thing, and they will mwk just 
as well This one works in my situation. 

?Open /etc/hllpd/httpd.conf in your text editor of 
choice (I use BBEdit ) and kx>k for the following directive: 

<Directory 'VLibrary/WebServer/CGI -ExecutabJ.es'*> 
AiiowOverride None? 

Options None? 

Options ExecCGI 
Order altovr.deny 
A11ow from all 
</nircic tory> 
and change it to read: 

<I)±rectory “/Library/WebSecver/CGl -Executables 
#AllowOverrlde None 
AiiovrOverride AuthContig 
# Options None 
Options ExecCGT 
Order allow.dcny 
Allow from all 
</nirGCtory> 


Thi.s will allow you to run the CGI's after you have 
authenticated ytjurself for the CGIs* To do that, we 
need to set up a .htaccess File in the cgi-bin directory, 
and then set up the passwords. Create a file named 
.htaccess in /library/WebServer/CGT-Executahles/ and 
set it up thusly: 

AuthName '*Naglos Access"? 

AuthType Basic? 

AuthUfierFJ 1 e /usr/l ocal / na g i os/otc/htpasswd , Licsers 
?require valid user 

Once youVe done that save it and close it. Now, 
before we create the password file for this, you want 
to know all the users that will be authenticating. At the 
very least, you want some sort of catchall Nagios 
admin user. For our example, we used nagit^sadmin, 
jwelch, and admin 
Run the following: 

sudo htpasswd c 

/uar/local/nagios/etc/htpasswd.users nagiosadmln 


This will create the usct file lhai aur .htaccess file is 
looking for, and set the First user to nagiosadmin. You 11 
be asked for the password for this user, set it to what you 
leel is correct. 
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To add other users, you run: 

sudo htpasswd /usr/local/nagio^/atc/hupaaavd.users 
<usGrnanve!> 

You do this once for each user you want to add. You 
only neeti the -c .swiich when you are creating tlie file and 
first entry. 

Then, edit the ■‘use_authenticatton" line in 
/usr/local/nagios/etc/cgi.cfg (or cgi.cfg-sainple) to reatl: 

U9e_authentic atioTi=l 

If you read that file, you’ll also note this is where you 
.sei which nagios user can dt) what. The docs that are a 
part of Nagios explain this thoroughly, and are available 
from the ‘"Documentation*" link on your Nagios home 
page, so 1 don’t have to. 

Conclusion 

I want tt> stop llie article here, liecause tlie next part i.s 
going to go into the configumtion files, which covers a kH of 
detail, and can i>e pretty dry. Unfortunately, there’s no nittf 
or easy way to jump in to tliat. 1 highly encourage anyone 
who wants to go ahead on tlieir own to do so, but witli 
caution, the config files c-an get a little (xld at times. I'd also 
encourage any readers who are not going to plow ahead to 
read llie Nagios docunientaLion thorouglily. Nagios has its 
own latiguage, and tlie more faniilmr you are with it, the 
happier yoifll lx? itsing it. A.s always, thanks tor reatling! 
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Cable Supplies 



Looking for a great selection of cables? 

MacTech has selected a quality vendor, with quality 
products for your cable needs, benefits include: 

• Lifetime warranty on cables 

• Same day shipping if you order by 4 PM ET 

• Express shipping orders can be ordered up to 
6:30 PM ET f(»r same day shipping 

• Huge selection • 3500+ items and growing 

Check out the full selection at the MacTech Cable Store 


http://www.mactech.com/cables 






Get OEM printer ink, 
and toner cartridge 
quality at a fraction 
of the cost !!i 


Inkjet and Laser 
Toner Cartridges 
That Create 
Professional 
Looking 
Documents. 
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|lnkjet cartridges for Epson, Canon, 
Brother, and Xerox printers. Black inkjet 
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cartridges from $3.99, color cartridges 
from $5.99. We also offer Genuine OEM 
HPi Canon, Lexmark^ Sharp, and Xerox 
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XRackPro2 

Noise Reduction Rack Mount Cabinet 


You walk into tlie room and are immediately Iterated 
by tlie thrumming and buzzing of machines. You try to stay 
cooi and keep focused on what you*re doing, but diere’s 
only so much anyone can take, Tlie noise just keeps 
drumming into your brain making you wonder, “Is this wliat 
Chinese w'aLer torture is like?” This used to be the server 
room here at MacTech. And, if yt>u are in tlie media world, 
it's not a matter of what is tolerable, ifs just not acceptable. 

Now things are much different. 

We have recently liecome a much 
less tomirecl group thanks to the 
XRackPro. The XRackPro, made by 
GizMac Accessories, is a rack mount 
enclosure cabinet designed to 
reduce noise and add mobilit>^ to 
Apple's XsL‘rve line of servers and 
RAID systems. 

Specifically, it's a rack unit on 
wheels that provides 121J of 
industiy' standard 19” wide rack 
mount space. Each lU of rack 
space is marked. 

During the past several 
months, weVe had several different 
types of rack mount uniLs fnjrn Xserve’s, to tape drives, 
to even a couple of super loud Linux boxes. Tlie 
XTfackPro not only is a beautiful box, it sigrdJlcantly 
reduced tlie noise — making even some of tlie loudest 
units toleralMe. 

We hid a few' concerns before the cabinet arrived. 
One was aeeessihilily. Tlie thought of getting your arm 
stuck inside of the eabinet was not icx) apyx^aling. We were 
thus liappy to discover thit :ill four sides of the cabinet are 
removable. So no one last an arm during installation, 

Anotlier concern was making it work to fit our needs. 
Having seveml other machines besides an Xserve that we 
wanted to put in the cabinet we wondered how well 
everytliing would fit. So we were happy to find fully 
adjustable mounting rails which allowed us to configure 
the cabinet to our own specific needs. 

At first, we were wondering whether we would like 
the “cage nuts” approach chat GizMac took, but we grew 
to see the merits of using cage nuts for mounting. Just 
make sure in your planning that you have enough of them. 


The one tiling that we didn’t like alxiul the XRackPro was 
the cable guides that mounted on the rails inside the unit, 'they 
came undone far tex) easily to really be usefiiL Fortunately, it 
wasn't particuhidy important. 

Jliis left us with our most pressing concern. Will the noise 
be redut:ed? We're happy to say it is greatly reduc'ed. In fact, the 
louder the device you are mounting, the more impad tlie 
XitackPro will have on it in reducing the sound. All of the 
exterior panels are lined widi specially 
engineered aaiusliail ftxirru Each dixir 
opening is sealed and aH wiie gtoiianets 
come with foam inserts. 'Ihe 
manufaaurer dainis 75% reduaion in 
noise levels. Wliat we can tell you is tliat 
iheie's a noticeable difference l:>etween 
when the front d(x)r of the unit is open 
vs. closed. 

There was one other feature that 
we have found to be a real lifesaver, 
the ability to liave mobility. The 
cabinet has 4 heav>' duty casters. The 
XRackPro made our recent move 
MUCH easier at .several different 
points. First, we were able to prep for 
the move by building the XRack out. On mc}ving day, those 
.servers were only down for about an hour as they were 
moved from one location to another. In addition, while we 
were building out the new^ server room at the new IcKation, 
tlie rack wa.s able to temp<3rarily fie in one rtx)m, and then 
easily roiled in later. It rolls easily across carpet and also 
makes getting to t he rear of the cabinet a snap. 

.So if you find yourself being sit:k and tired of the noi.se 
that conies with having seveml macliines running at once, or 
if you need to have easier acces,s to your Xserve, you should 
consider an XRatrkPro. 

http://www.xrackpro.com. 

S1799 is the list (iricc, with additional accessories 
available. 

Titil 
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MacTech 2005 High-Tech Gift Guide- 

Gift Giving Goodness 

Some of the Best Stuff for the Techies on Your Holiday List 

By Michael R Harvey^ Lesa Snider^ and Aaron Adams 

It’s that time of year again, kids, time for our best picks for holiday ^ 
gift giving. Whether it’s Christmas, Chanukah, Festivus, or whatever, | 
the following is what we think are gi‘eat holiday gift ideas for 2005 . J 


Sonos Digital Music System 

When I ix)u^hl niy lioinc a few years ago, I had Llie 
opportunity to wire it before the drywall went up. Cat 5 wire 
went in all over the place^ of course, but 1 also put in a bunch 
of sfX 2 aker wire, thinking 1 would use that to pump music into 
every room from a central point in the house. Well, most folks 
donh have the chance to do that. Sonos has a very cool method 
far gening the same result wiihout having to run a hunch wire 
all over tlie floors or tear into the walls. 

The Sonos Digital Music System is a hardware/software 
(‘oinbination that takes your rniisic collections, wherever they 
are stored, and lets you play them in any room in the house. 

The Hardware 

The Sfrnas Zone Players are the devices you put arcHind the 
house that receive tlie music signal. Tlie first one has to eidier 
j:)lugged into a muter, or put inline l^etw^een a computer and router. 
H(xik up the .speakers, plug in the power, and you are ready to go. 
After tlial, every additional Zone Player you bring online (uf7 to 32 
total) can be connected to your Sonos network via Btliernet, or 
attached through its own Sonasnet seaire peer-to-peer wireless 
network. On ilic hack of each player are RCA jacks and wire 
temdaals for attaching spetkers, as well as a four-poit 10/100 switch 
that lets you attach any additional network devices yoifcf like. 

Tlie Sonos Controller is the device you use to manage the 
Zone Players, and set what songs play on what Zone Controllers. 
You can have a different song playing from each Zone Player in 
the house or link them to output the same song. The ctinirolier 
is easy to irse: Pick a song, pick a zone, and jiush play. Yoti am 
control any zone from anywhere w^itliiii range of the netwwk. 
(It could be a great way to freak out someone in the bedroom 
frotii the backyard!) Some otlier feaaires include: 

• Tile 3-5’' backlit color LCD screen is easy to read, indtxirs or out. 

• ifs splash resistant; all die seams are gasketed. 

• It has a built-in motion sensor so it autoniatically wakes up 

when you pick it up,. 



The Software 

Run the installer on your Mac (or Windows PC)^ and it will 
install the as,sisuim software, guide you througli configuring and 
ojiening up your network to Sonos, and imking your music 
collec'tioas available to the Zone Players. After diat, the S^mos 
A.s,sistani application am manage your rig. Witli the Assistant, you 
can name your set up and zones, add/delete additional music 
collections, and control how' the system works and connects. The 
Sonos system supjitms M1^3, AAC, WAV, and AIFF, among others 
(although DRM encoded files are not cunTently suppoited). 

The Sonexs Digital Music System is for audiophiles who must 
have their music follow iliem throughout die house. This will lie 
a [irlcey gift. Ilie ixtse system of tw'o Zone Players and one 
controller will nin $1199 (a system including two sets of high 
performance IxKikshelf s|x.^akers is $1199). Additional Zone 
Players are $499 each. Go for diis and youT pretty much blow the 
Christmas budget; though, you will score serious brownie points 
if you give k to someone instead of keeping it for yourself. 

One final note about purchasing a Sonas system: When you 
do, you get an extra Ixinus. Because they liave entered into an 
aga^ment witli Get Digital music’ cxinversion service, you get a 
disaiuni on tltcir CD to MP3 conversion service. On an order of 75 
or more disc’s, you gel 25 free. A pretty* nice deal on a veiy good 
servitx?, but well tell you more about that later, www.sonos.com 


Till 
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Gift Buyers Advice...the MacTech Way! 


EyeTv and EyeHome 

i’ivo is a great prcxluci. It lias a slew features that make 
it better than any VCU ever conceived, but it's too easy* II is a 
consumer device. El Gaio has a tar geekier sofution to get the 
same functionality, plus a few tricks Tivo c-an’t turn. Tlie 
combinaiion of the EyeW 2CX) and EyeHome units gel your TV, 
Mac, home network, and nerd gene all involved in the digital 
recording of television ctintcnl 

Tile First ctimponent of the fun is the EyeTV 200, It’s a small 
lx)x Lhai gets your cable TV signal into your Mac. It liiis a 124 
diannel analog TV tuner that can take in any basic (unencoded) 
cable .signal via coax, and put it on your computer .screen* It also has 
composite and S^Video video in ports for hooking u|), say, a VCR* 
Vtlth those extra conneeiors you can move old recorded tapes onto 
your computer via tlie EyeTV Ixix. Unlike its predece,ssor, ilie KyeTV 
USB, the 200 txinnecTs vut—^and can be powered by—^FiIvWi^.^ 
FireWire allow,s the EyeTV unit to move more dita into tlie 
computer, making recording of liiglicf quality daui p<xssii>le. The 
EyeTV 200 turns your computer into a DVR, and records MPEG-2 
DVD quality data. Pausing live television, time sliifting, and 
recording .shows—ifs all there. Plus, EyeW does things your Tivo 
oanoof. With the included and regukirly updated softwaie, you liave 
the ability to do Ixisic editing of your .saved TV shows. You can also 
burn saved .shows to VCD or DVD, using Toast. Or, you can expon 
your accorded shows into iDVD, or iMovte. Prognuniidng of EycTV 
is liaridled Lliixiugfi the TitanlV web site. ‘Fhey integrate seamlessly, 
and it works very well. In faci, you can set up TitanTV and KyelV 
to pmgram shows for recording over the Internet, llie EyeTV is, by 
itscU, a great pnxluc't* It’s just hin to use. 

Tlie next comixmc-ni in this jratchwork of geekery is the 
EyeHome. 'Ihis is the bit that c'onriecis your computers EycTV 
ardiive of sliows with your TV, over your home network. Note, 
however, that you don’t necessarily need a wire to put the 
RyeHotne on your network. El Gaio lias instructions on tlieir wch 
site that de.scribe how to use an Airport Express Co put your 
EyeHome on llie LAN wirelessly. EyeHome has a software 
component that provides the link to tlic EyeHome Ik>x* Tlie box 
iLself connects to the TV^ via component or optical cables. Wlien it 
Is turned on, and logged into your computer, you get a menu that 
lets you access the stoied EyeTV shows ytiuVc rccr>rded. TliatVs not 
all, though: The EyeHome allows you access to your iTuncs library, 
your iPhoto lilirary, and die a)ntcnt.s of your Movies folder. You can 
play all the clips you have stored on ytjur ctmputer; .something 
Tivo ha.s been promising Mac users for years but has yet to deliver 
EyeHome uki has Web actress, but it works about as well as 
Web'IV, which is to say, not at all* Tlie menu driven interhice Is 
okay; iPs not the smcxithesT operation, but it works and ycHj can 
watch riKxst anydiing. It plays MPEG 1, 2, and 4, and DivX. It plays 
a laundry list of audio codecs, as well as displays jpg, png, gif, and 
bmp image Formats, 'Ihe EyeHome has ifs own reinac with pretty 
standard function keys*; it get.s the job done. Even better, thougli, if 
you’ve got a Uannony Remote, you tran program it to control any 
of FJ Gato's produas. 



Either of these units, by themselves, are a neat addition 
to the geek’s arsenal; particularly the EyeTY. It could be 
especially useful in, perhaps, a dorm niom, where .space is at 
a premium, Both together, tliough, are a great joy to use and 
me*ss with* 'Hie folks at El Gato are constantly improving the 
features and utility of IkhIi unii.s and the software* Any 
person on your holiday list who loves to mess with stuff, or 
do things the differently, will really enjoy these two items. 
www.elgato.coni 

'/ill 

One for the Kids 

The Mac Mini is an excellent little computer for kids. 
Tiny, quiet, and plenty powerful, it is the perfect computer 
for your youngster’s lx!d or dorm room. Tack on a LCD 
screen, keyboard, and mouse, and you have a compact unit 
capable of anything a school kid might need for around 
$850* It w^on’t crank on some of the top end games out there, 
but it will do just about evcrylhing else* And, since Apple 
upgraded the standard RAM to 112 MB, out of die Ik>x the 
system is very usable. Tf you have a kid who needs a 
computer, you really canT go wrong. 



'i'll I 


MAcmm 


MacTech 2005 High-Tech Gift Guide 37 












MacTech 2005 High-Tech Gift Guide 


Lift and Separate 

For some time now, conventioml wisdom has ditiaicd tfuiL 
tilted keylx>nrds are Ixid. Kr^onomically, tlie angle your wrists sit 
while typing on a litled keylxj^trd promote repefirive stress 
injuries. So, since tlie PowerBook G3, tlie ability to angle the 
keyboard ot‘ Apple laptop computers has Ixajn missing. While 
that was good for your hands, it had the minus effect of 
removing the airflow from underneath the laptop. Heat ensued. 
Tliere have been a few prcxliicis rclciised lo helj) with this issue, 
such as the XSiitnd, which hap|>ens to be the perfect stocking 
.stuffer ll consists of a collapsible metal frame which lifts a 
laptop off the table. U is sixe adjustable to securely hfjld any 
sized laptop computer, as well as lieiglu udjustahie (you c'an 
increase the angle). The one issue is that the minimum angle of 
die XStand is still too great to type on comfortably, li dot's 
produce gcxxl air flow underneaUi it, and places llie seamen at a 
more comfortable height olT the desk for viewing when you plug 
in a kcylxiard. 'iTiis is a really goexi gift for the Pcm^erlkiok user 
in your life, www.xstaadcom 


^\\\ 

Gigs on the Go 

Small, USB thumb drives are lK:c:oming standard I arc on 
keyt'hains all over the place. Tliey are great and very convenient, 
l>ut sometimes they lack the capacity to move the big stuff. I laving 
jX)ttabIe drives ifuit can arn on bus power is a great alternative, 
such as the one from Tninscend. Tlie Storelet 1.8 is a USB 2i) cirive 
that is Ixickwaids compatible to LL It's very compact, smaller 
tiian a deck of cards, and quite zippy. Format it the right way, and 
it will plug into both Windows and Mac systems without a hitch. 
This is great for moving files lietw^een platfoims, as well as 
Ixtw'een computers that lack FimWire ports. It <x>mes in 20 GB ^ind 
40 GB sizes, WTV'w.tnmscendu.sa.com 

Till 

Carry On 

'Ihere are myriad laptop rases and hackjiacks out there, and 
our advice (whenever w'e review them) is to put your hand.s m 
it and try it out before buying. Itiai ran lx; difficult to do when 
gift buying, so you'll just have to take our w'ord for it tJii these 
two. Tknh of iliesc rases arc really good choices for someone 
wfio wants a good-sized hag that carries a lot, but just as 
imponantly, lcx)ks both cool and profe^s,sk>nal 

From Brenthaven, a perennial favorite here at MacTech, is the 
ProFile 1Z^15 case available from the Apple Store. 'Iliis $129 case 
is an excellent combination of size, looks, and lugg;ihliiy. It is 
nearly sqiutne in shape, a bit thicker Uian some otlier shoulder 
cases yoti might come acnxss, [>ut very comfojta[:ile to orry on 



your shoulder. There are numerous ptx keis to carry any number 
of cables, accessories, papers, you name it, a strap built into the 
■sicle that you can slip over tlx* Itandles of your roll away luggage, 
as well as tite ultra secure laptop cx^mpanmeni that can handle up 
to a 15’* laptop. Class and utility. Tit is Ls a perlect choic'e for the 
biLsine.ss traveler on your list, www.lxvntltaven.coni 

Now, TlnibuklZ c’ases haven't ever really l>een known for 
staid, classic looks, OxA and wild are more fitling lalx;ls. 
However, they do have the Lipttjj:) Zi]7 Briefcase, which boasts a 
very classy ltx)k while still Ix'ing cool 1'his Ixig, made of bailistic 
nylon, is cavernous. If they made a 35'' laptop, the Zi[> Briefcase 
could likely li^indle it. It has a vt:iy toniibilable shoulder stntp and 
handles (mtsre aauibnable than the lirenthaven), two (juLside 
ptxkcLs—one jxrfectly sized to hold plane ticket.s—and a well- 
padded interior. 'I'he wild (Y>mes into [day on the colors. The 
design and l<X)k of liie Zij> Briefcase is very professional, but in 
olive green or Navy blue, and it Incomes a little mom c:ix)l, 
something other cases of its ilk lac'k. It's an excellent option for 
the young, mof>ile professional. ww'WMimliuk2.com 

Till 

Lots of Fun 

While Uiere haven't been a ka of games released thN year for 
the Mac, compaietl to earlier years, the (giality of liiose games has 
lx*en particularly gtxxl. Here ;ire some ol' tlie Ixst, gift-worthy 
picks for your favorite gamers lhi.s holiday seas€7!i. 

Lc'l’s start right at tlie tup with tlx very Ixsi: ljegt> Star Wars. 
Ported over (rom tlie raasole anena, this game is mote fun than 
shcHild lx allowed. I’layed fioni llie ihiixl perstjn perspective, you 
take on itiles of over 30 clwacters from tlie first three Star Wars 
movies, from Jango Fe«, to Jar Jar Bifik.s, to IjaitJe droids. Play 
through various scenarios of ilie first ttinx" movies as Legps. Game 
play Is very easy, Tliere Ls very little difficult)' to playing, st> anyone 
can quickly get up to speed and start enjoying tliLs game, i laving 
said tliat, the simplicity of this ^me Ls wiiat makes i! so enjoyable. 
You dc^n’t fiave lo wcjrry a!x>ut solving complk'ated puzzles or 
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iinyihing like that: You jiLsi liave fun lx.4ng a litile Ijego cliitie. It's 
great ftjn for anyone in the family lo play. Bonus items Lt>llcaetl 
tliroLigli a level liclp you build a Lego version of a sliip from tliai 
level (a ixkI racer for example), Gjlleci 1^'go bits along the way, as 
money, an<i buy add on items. l*or example, you can give everycjne 
mustaches, or (and this was my lavorite) turn all tlie liglH Siil)en> 
purple, Ita.’ause it Ix^an life as a coasole Ijego Star Wars 

plays Ixisr using a game emtroUeL Tlie Nyko Arifiow, re^'iewetl 
earlier iliLs year in Marlah, is one of tlie lietler choices. It Is very 
comfortable, has gcxKl, easy to use, set-up software, and liest of aH, 
hits a fan that pushes air tliiough venLs in tlie controller, cxxiling your 
iiiinds and keeping them from getting sweaty. ^vww.aspyr.ctJtn 



Next Ls Cxjrnmand iind (Conquer Genemls: Zett> Hour The 
origiruil Cuinmiind and Conquer game was ported try the Mac, but 
tJie se([iieis hiiven’i Ixen seen on our platfonii until kst year when 
AspVT pyried the latest inoirriiition. Generals. Zero Hour is an 
excellent add-on jxick lor Generals. It provides new^ units, buildings, 
maps, and additional game pkiy tliat gives you many more hours of 
fun witii iliLs If you or yours is a fan of reakime siraicgy, 
Command and Conquer Is the Ixst there is. w^^\aspyrxx)m 

Anexher great strategy game is Rise of Nations. In this universe, 
you a>nin)l the powers that nuike civilization. You liegiii in ancient 
times, with a single village, and grow from there, building your 
c:ivili7ation tlirougli the ages, litis game is mut:h like the old 
CiviliziUion ginms, but iasteaci of lieing tum-lxised, you play this 
one in mil liiiie, Cxynquesi ts the main goal, building ycxir annies to 
take over any of the If^ other civilizations you may face. You can 
also build Wonrlers of the World, from whicli you receive Ixtnus 
abilities. Tliere are two oiher grme play modes. One is multiplayer, 
where you can set and manage the parameters of the scemiiio, and 
liave otheis join in via IAN or internet, Tlie otlicr is Con(|ucr the 
World, a .scries of linked .strniirios that take you through time in an 
effort to cake over the world, wwu .mac's^yftxom 

Then weVe got Project Nomads, from Freeverse Software. 
Tltis game is a tiiial perstyn perspeaive shooter, essentially, but 
it's also more. It's got a very inlenestirtg story, and one of three 
charatters to play the game witli Eacli cliaracter has his or her 
own strengtiis that you leverage to complete missions. TItc world 
in which you o{XTJle is one where your planet w^as destroyed, 
leaving massive islands of rock floating in the etlier. ft reminds me 
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3 lot of the novel 'Ilie Inregnil Trees l)y Larry Niven. Your mission 
is to find ihtrse who caused die destruction of your world and 
destroy diem. You have die option of LAN or Internet multiplayer 
gaming acdon. One of the really axil dlings alxiut this game is die 
freedom t>f movement. Fly from island to island, with no 
boundaries, it's fun getting to explore outside the confines tjf your 
current mission, www.freeverse.com 



Vill 


Fifteen Minutes of Fun 

This this day and age, you often don't have time to commit 
u> playing an involved game like the ones alxive. Sometimes 
you just to want to kill a few^ minutes widi something fun. 
GooBall and Jammia' Racer are two excellent choices. 

GooBall, from Ambrosia Software, is odd, quirky, and 
really nice to look at. You are, well, a little ball of goo, with 
four eyes and a dipper, trapped in a bubble, winding your 
way through various levels, reaching the finish line as fast as 
you can. You have the ability to leap over gaps and .stick to 
walls. It makes for some vertigo inducing perspectives. The 
level variety is astounding and very imaginative. It's a blast to 
play, www.3mbrosiasw.com 

Next up is Jammin' Racer from DanLubGames. Here, you 
compete in various dune buggy races, trying to, obviously, 
win the race. Each Cup (there are several) has four races 
w^hich must be won in order lo advance. Drive your sand rail 
in all manner of environments, even on the moon. There are 
a liunch of customization options for your ride, and you can 
also go head to head with two player gaming. It's a liunch of 
fun. www.danlabgames.com 


A Little Light Reading 

Ihe Unofficial Lego Builder's Guide, by Allan Bedford, is the 
lxK>k for tlie person in your life who still, to thi.s day, has tlieir very 
first Lego set, and who still pulls it out for jxriodic assemblage. 
11iis ix>ok IS not for a seven ycnir old; it's for serious Lego freaks. 
It sh(>w.s you, among other things, ways to put Ijegos together, how 
to sort and store them, and even gives you a .step-by-step for 
building a space shuttle. Very ctx)l. Front No Starch Press. 

These next books are some pretty heady stuff. The Apple 
Training Series, from Peachpit Press, is an Apple Certified 
series of technical books designed to help you, or yours, pass 
the exam for the various Apple certifications. Edited by the 
likes of Owen Linzmayer and Schoun Regan, tliesc volumes 
are packed with informatitm on supporting Mac X, laptops, 
desktops and servers. These babies are essential additions to 
the library of any system administrator or techie looking to 
l>ecome Apple certified. 

Tit I 

Nice Dreams 

Nobody gees enough sleep anymore, I'here just isn't 
time, or you canT shat your brain down, and it runs and 
run.s, keeping you awake into the wee hours. Medication 
can help, hut popping pills isn't a long-ienn solution* 'I'here 
is another way. Pzizz is a very interesting little program that 
will run on your Mac and generate naps that you listen to on 
your iPod, helping you get that power nap, or couple of 
hours of sleep* 

T\\c interface kx>ks a bit like a collapsetl I'funes window, and 
using the program is as simple as using iTunes. Clicking on the 
generate nap button will do just diat* Yeju can configure how the 
nap, or sleep, wall lx? generated from within the Configure Naps 
window (below). Here you set the length of time, volume* 
whether or not there us a voice, as well :\s view^ the stored 
configurations you already have set up. 

1 tried Pzizz on a red-eye flight from l.A. to Boston and it 
was wonderful, ) have trouble sleeping on planes, hut 1 got 
four good hours witli the four, one-hour long sleeps 1 created, 
i got to Boston rested and ready to go to work. Cumi^are that 
to the same fiight a year earlier, w'hen I showed up ready to go 
to bed and couldn't get my act together for a day and half. 
Running four one-hour long programs on the iPtxl ate tlie 
battery, though. You might want to create smaller sleep files to 
increase battery life. 

Xeric Design* die makers of Pzizz, have the prtxluct 
broken down mto two parts; The main part is the program 
itself and the energizer mtxlulc. There is also the add-on sleep 
module, tliat lets you create the longer sleeps, Pzizz is S39,95t 
including the nap module, w^hile the sleep module is an 
additional $19.9'>- ww^v.xericdesign.com 
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Configure NAps 



may be accessed by usiing the 
popup bunoh ifi the player window. 
A pzizz icon indicates a default nap. 

Have a good nap. 


Nap Type: ^leep ___ 

Effectsr [ "Aurora*’ Stereo 
Voice: n^ular ^ 

Length: '■ i GO min. 


til I I t I I i 1 Y 


Volume 
Music Voice 



10096 60 « 


CJED 



^ Descr^on ‘ 

6C> mio, sleep 

GO min, sleep no voice 

1 Energizer N«p 

Default Energizer Nap (20 min.) 

P Sleep Nap 

Oefaull Steep Program (30 mmi 

C Siort ) Replace 

( Cancel ^ f OK } 


Yill 


Musical Digerati 

You know you have someontf in your lift: with stacks of CDs 
and a mrarly empty iPexJ, They, like almost ail of us, simply lack the 
lime to put eadi disc through flunes and convert it. In the past, the 
only options for conversion servitx^ were c:<>llegc‘ kids in dieir dorm 
fxx)ms, and the resiilis were a.s varied as die quality of the dining 
iiMiimons lunch menu. Now, Get Digital is on the scene to pul a 
professional face on this type of servict?. 

'The service itself is very many things: Veiy fast, very 
pr(>fes.sional, and very good. Wlien you order their service, they 
send you all the packaging materials you need to get your CDs 
to them, including a prepaid FedEx lalx^l (die level and cost of 
which you set wlien you order die service). Once you get your 
ct^llection to them, it takes mere days to completely digitize your 
colleaion into 192khps MP3 files (or higlicr, if you'd like), 
including full, and accurate metadata, which they load onto 
DVD media or your iPod (or other IVIP3 device), if you chtK)se 
to ship it to them. It's then reloaded into the sturdy shipping 
boxes and sent back to you, alsti via FedEx. Oh, they send all 
the di.scs [rack to you in the same order you sent them in, 
making it much easier to get them back into their jewel t'a.se.s, A 
very nice touch. 

11 le pricing and t5()tions on the seivice are another very as well: 
very' rcasonabie, Ihe base price of the ser%ace mnges fmm 99 cents 
to Sl.49 per disc, liased on the numlxT of CDs you send tliem. The 
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BRADLEY M. SNIDERMAN 








If you're developing software, you need your valuable work protected with 
trademark and copyright registration, as well as 
Non Disclosure Agreements. 

Then, when you are ready to sell it, you can protect yourself further 

with a licensing agreement. 

I am an attorney practicing in Intellectual Property, Business Formations, 
Corporate, Commercial and Contract law. 

Please give me a call or an e-mail. Reasonable fees. 
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3,248 hours typing code 
184 hours finding that one bug 
142 hours of meetings 
108 pizzas — 


-^ --!!■ L,lj; ■ 

14 cancelled weekend trips 
11 all-nighters ^ 


1 call protects it all! 



SOFTWARE P M 


#f tfioice of Software Developers 








The new HASP family of products is the 
next generation in protection ensuring the 
highest level of security for your software. 

It provides an easy set of tools to automati¬ 
cally protect your software and implement 
new and innovative licensing options- 



^ Strongest anti-piracy solution: 


EKOtYTTEO DATA 


Our powerful* 12S-bil AES 
encryption provicfes a 
strong locking mechanism 
that ensures you get 
paid for every copy ot 
your software. 



DECRTFrED DATA 


^ Best overall solution as rated by 
an independent testing lab: 

In Key Labs testSH HASP HL outperformed 
the competition In security ease-of-use* 
flexibility of tools and functior^ality 
and compatibility across platforms 
and environments, A copy of the full 
KeyLabs report is available from our 
Web site at www.ai add in com/hasp 


^ Robust envefope: 

Automatically protects Windows 
executables, DLLs, Net and 
Mac applications* securing the 
weakest link and ensuring your 
valuable (P remains unreachable. 
Multiple protection layers 
provide unequaled security 


R^indom multiple 
protection ky«rs 



Caieg<uy 

Weight 

Aladdin Sentinel 
HASP Hi UltraPro 

Security 

3S% 

85.1% 

60.9% 


25% 

93 J% 

77% 

Lken&ing 

20% 

75% 

75% 

Fienibiffty of tMls 
and furKtlQiiafFty 

10% 

93.3% 

71.2% 

Compatibility across 
platfomis and 
envirofimems 

10% 

93.3% 

7t% 

Overall Evaluation 


87.3% 

69.8% 


Request a Software Developer Kit today at wwM.aloddin.com/hQ^ 



SECURING THE GLOBAL VILLAGE 


North America: t-800-S62-2543, 847-818-3800 UK » Germany • Israel • Benelux ♦ France ♦ Spain • Asia Pacific * Japan 
02005 Aliddin l&wjvrfpdgeSysm Uii AB Fights lestwd, Abddin and HASP Are Alattiiln Knnwlpiige Sjvitms, Ld. Mtac OS*, Unior* aiE [rademarbfir rifgi5i0diradeniarb(iit'th(*lriEspecifV£ holders. 
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‘itandard reaim a'lethod is DVD^ btit you liavc ilic cj|)tion of 
purchasing a Maxior uxlumal drivu, witli options dial Ixfgin at 100 
GB for $ IBS, and liavc your music loaded onto tliat instead Sending 
diem an iPod to load incurs no additional aisL And, ft)r SI diuy will 
drop a three-ring binder in tlic sliif)ping box, with a color catalog of 
your collection, showing cover art, and tracks (the catalog is in 
alplialietical order). 

1 sent them 69 cliscis and tried to drop a few zingcts in to trip 
them up (a rcrally old Mozart CD, and an obscure country miLsir 
disc, among others). 'Ihey got all the data right and C{)uld not find 
cc]ver ait on only two CDs, Not too Irad, at all And don't forget the 
deal you gel with the Sonos system! ^Tvw.getdigitalincxom 

i\\\ 

iPod Shuffle Accessories 

In an earlier issue this year, 1 put the iPod Shuffle at the top 
of my List of must liave iPod accessories. So as not to make the 
Shuffle feel inadequate, here are a few of the Iiest in Shuffle 
accessories. Any of tiiese will lie a welcome stocking sniffer 
come Cliristnias morning. 

Belkin Hi-Spced USB 2,0 hub 

Now, this hub from Belkin Ls, in esse^t.t.^ mucli like twry otlier 
USB 2,0 huh IL is powered, Irackward compatil^le to USB LI, and :ill 
tliat odicT stuff. Tile one tiling tliat sets it apart is a port penciled atop 
the hub, making it easily accessible for y<jur tPod Shuffle. Getting 
around to the back of your iMac:* or pretty mutii any cHlier ojinputer, 
except the G5 tower, is tough, especially when adjacent ports are 
already in use. With the Belkin hub, it s dead simple to htKjk up tlie 
Shuffle, www^belkin.com 



DLO Action Jacket 

Exactly 42 seconds after the Shuffle was announced, 15 
different comp:inies shipped some fonii of protective covering For it. 
And they are all pretty much the s;ime: Varied bits of pliistic in 
various colois. Yawn. Ihe DLO Action Jacket, though, sumds out. It's 
a good pick because trf its versatility out of Uic Ixjx. It comes with 
Ixxh a bell dtp and an arm Ixmd. Tlie psidded case Ls rruide of 
neoprene, so it's a nice protector against moismre (like sweat), as 
well as from Ixings and sc'ratches. Pull tlie case off die l>elt clip or 
arm band, and just have it hang anwnd your na.'k with the standard 


Apple lanyard Ihe belt clip ts ,'^n>ng, and lets you rotate the Shuffle 
180 degrees. Ttie arm band will fit almost any arm thickness, faun 
.scrawny to brawny, A very good all-in-one .strlulion. 
WWW .e verythingipod,com 

XtremeMac AirPlay Shuffle 

One of my favorite iPod 
accessories has always been FM 
transmitters. XtremeMac came out 
%vith the first one for the Shuffle. Ifs a 
small unit that plugs into the power 
port in your car wliich charges the 
Shuffle, as well as iransmiLs die signal 
over FM. It lias a small LCD screen 
showing the current frequency it's on. 
Also, and this is iLs nicest feature, it 
has three preset buttons, allowing you to reiune it with one press. 
A good idea considering the numerous distracted driving laws 
floating about these days, www.xirememac.com 

YiU 

Look Ma, No Hands 

Sjieaking of hands-free cell calls and di.strat:ted driving laws, 
we had the chance to try out a couple of hands free headsets, 
eiihcr one of which will w'ork great Ft>r gift giving, depending on 
the cell phone. 

Fifst up is die jawixme made by Altpli. Tills lieadset uses what 
Aliph calls Atktptive TLt.hnology to Ciincel outside sound while also 
picking up your voice more effeaively dian other hands ffee units. 
In tc-sting in noisy environments, the Jawlxme wcjrked very wdl; my 
voice was clear to ilic culler :md I crmld hear easily. 'Ihe ear piece 
Is pretty comfortable, too, allx^it a bit heavy, tt is ea.sjly adjustable lo 
ftl into either ear. There is a clip ulx>ui half way down the wire, 
which houses the Jawix)ne',s circuitry. Tlic clip also has a button that 
acts as eiiliCT an accepU'end call button, or mute button, depeuding 
on whidi phone you mcxlel you luse, as well as an on/off slider to 
activate or dLsttble the atkipLive aspecis of tlie Linit. 'Uie aitch with 
this unit is the ctmncclor: Because the |awl>one interacts with the 
phone's software and needs to draw power from die phone's 
Ixittery, it only works wiih a limited set of Motorola, Nokia, and Sony 
Fric'Sfion phones tliat have data pt>i1s on the bottom. You will have 
to clicxk die Aliph wc4i site to make sure a phone ts cxjiuixatil^le. If 
it is, it's a goexi choice. wmv,aliph.a)m 

For thcise of us lacking a phone supported liy the Jawbone, 
Shune lias an option tlxit is at least as gcxxl. Shore makes high<md 
audio equipment, including h^d .sets and car Imds. Tlieir sound 
isolating designs work belter, in my view, titan die best sound 
canceling ic’chnology^ out tliere. Ihey have exrendeti tliis design 
genius to a hands-free cell phone unit. The QuietSptx Bexjm headset 
(model numbers QSHB3 nr QSHBD is a great. light-w^eight, eiir 
piet:e, with tiny lxx)m mic ilia! plugs in, out of the box, to the hands- 
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free ix)ri on moi>l every [)[ionc made. Tfiose few wIk) don’t have the 
proper 25 mm jack can get an adapter to inake it fit. This unit fits 
instantly into eitlier ear, as it’s held in place by wrapping the wire 
over your ear. Check the weh site for a complete eornpatibilily list. 
Ifs very^ coinfoitable. I'he sound, both in and oui, is also excellent. 
The noise canceling Lx)om mic, which eliminates up to 70% of 
outside noise, picks up your voter very well. Tlie ear plug (the unit 
comes witli Lin assortment of sleeves to fit any ear canaO does an 
outstanding job of keeping outside noise out, making it very easy to 
hear who’s calling you. www.shure.cotn 

'i\\\ 

More Free Sound 

Bluetooth is cool; il makes wires go away. Tlie things that 
can be done with it have the potential to make wires utterly 
obsolete. A move in that direction is the iCombi, a wireless 
headset unit designed to receive signals from, among other 
things, your iPod, 

iCombi isn’t the first unit of this type, but it Ls, so far, the 
best. The design of the head.set is pretty compact. The 
materials are strong, and the unit is well-built. It ha.s a folding 
design to make it easier for compact storage. Built-in batteries 
are charged via HSB or wall charger While it’s heavier than 
most headsets, it’s not uncomfortalile. You can keep it on for 
long perkxls of time. 

The headset itself is only half the equation. It links to the 
other, and more impoitant, half. With a dongle designed to 
attach and he powered by your iPod, you can listen to your 
runes without getting caught up in the wire snaking from your 
iPod to your ears. Ifs great if you’re active, .say mnning, skiing, 
or the like. It can also connect to a variety of other devices, and 
your computer can feed sound ro the headset. If your computer 
doesn’t have Bfuetooih built-in, iCombi has an optional IJSR 
dongle designed to make die link. Also, iCombi has a general 
audio dongle for connecting to standard audio devices, like a 
stereo, giving you another way to filay tunes wirelessly on the 
heLidset. And, just to l^e clever, die iCombi headset can also act 
as a hands-free device for your cell phone with its built-in mic. 
Just pair the lieadsel to your BIuet(x>th cell phone and you can 
move, with the press of a button, from listening to music to 
answering calls, ww^w.icombi.com 


/ill 

Explore 

"ITie Nationa! Geographic Back Roads Explorer is a map 
geek’s dream come true. Delivered to you on 18 CD-ROMS, this 
package has detailed tojxjgraphic maps of die United States, 
including Alaska and Hawaii. With this application, you can plan 



trips, annotate and print out maps, and transfer and view them 
on either Palm or Pcxket PC devices. The CDs are loaded widi 
over 2,000 U.8. Geographical Survey maps, with road and trail 
overlays, giving you a very detailed overview of any area. Plus, 
you can use tlie Baek Roads Explorer to program your CPS to get 
you where youTe going, as well as get llie coordinates for over 
one million locations. 

The installer comes on Disc 1 and loads up the appliealian, 
named TOPO, and lower detail maps of the US. You can copy 
the more detailed niLips of each state by copying the directory 
fron^ the .state’s CD to the TI^0_DATA folder on the hard drive. 
The interface isn‘l the prelliesl thing you ever .saw. You can lell 
this is LI pon, but it is usable, Lind feLiture complete. If you have 
someone who is into maps or geography, or w^oukl like a way 
to [>uild really detailed travel niute.s, or ju.st find interesting 
things in the place.s you are heLiding to, this is a great box to put 
under the tree, maps.nationaIgeographic.com/topo/backroads/ 


/il I 

It Came Inside 
A Midnight Beer 

This Jingle Isn’t A Bell 

Company lioliday functions populated by the inane and tlie 
insipid. A Christmas Eve spent with distant relatives, unseen 
since last Christma.s, yammering on about the minutiae of their 
Ixiring personal lives. Mounting credit card debt. The same 
boring Christims specials that have been on television for 
tw^enty .straight yeiirs, A freezing Saturday afternotm spent 
hanging uncooperative lights and decorations. In-law.s. 

Wliat do all these things liave in common? 

Beer! 

Whether it's being consumed on a silent night at home, al a 
holiday party, or to take tlie edge off of awkward social situations, 
alcohol is part of tlie holiday ritual for many of us. And what 
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Innovations by InterSystems 



Rapid development with robust objects 



Li^btnin^ speed with a multidimensional engine 



Easy database administration 


Massive sealability on minimal hardware 


No More Object-Relational Mapping. 


Cache in the first multidimensional database for transaction processing and real-time 
analytics. Its post-relational technology combines robust objects and robust SQL, thus 
eliminating object-relational mapping. It delivers massive scalabilifs- on minimal hardware, 
requires little administration, and incoiporatcs a rapid application development cnviroiiniciit. 

llicse innovations mean taster time-to-market, lower cost of operations, and liiglier 
application performance. We back these claims witli tliis money-back guaraiitec: Buy Cache 
for new application development^ and for up to one year you can return the license for a full 
refund if you are unhappy for any reason.^ Cache is available for Unix, Linux, Windows, Mac 
OS X, and OpenVMS ™ and it's deployed on more tlian 100,000 systems rttngiiig from two to 
over 50,000 users. Wc are InterSystems, a global softw^are company with a track record of 
innovation for more diaii 25 years. 


InterSystems ^ 

CACHE 

Try an iuntwativc damhiise for free: Download fiilly ft mcrionai, non-cxpiring copy of Cache, or request it on CD, at www,liiterSystcius.coiii/Cachcl4HH 
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could Ix^Uer on a cold winier night limn an ovcrsturfcd recliiier, 
a crackling fire, and a cold glass of thick, black, bitter stout? 1 
speiik, of coursej of Guinness, the magic wonder brew that seems, 
at rimes, to be the solution to al! of life's prcjhlems. 

Guinness drinkers may have noticed of late a jingle in the 
can or bottle of their favorite holiday hops, lhat noise is none 
other than the Guinness widget, a clever device invented ]>y 
Alan J. Forage and William J. Byrne, according to the widget’s 
patent, which forms Guinness's characteristic creamy, foamy 
head once a can or bottle is opened. 

Whaf.s so special about Guinness lhat it needs a widget? 

Beers are carbonated to different degrees as a consequence 
of the yeast metabolizing sugars in the fermentation prexess. 
Sornetimes addit.if>nal c'arbon dif>xide is dissolved into the brew 
as i! is packaged. The dis,solved C02 in the Ixrer causes the 
container to become pressurized. Liter, when the beer is 
opened, the pressure is relieved and the C02 bubl7les oul of 
solution to the surface and creates a head on the beer. Guinness 
is a little different. It contains less C02 than most beei^i so 
nitrogen is added, which works in combination with C02 to 
create tlie smaller bubhie.s that enable Guinness lo liavc its 
tliick, creamy head. I'he nitrogen dissolves into the beer, but 
not very well, so it bubbles out easily when the container is 
opened. The C02 in Guinness, however, is more difficult to 
extract * the f)eer isn't saturated with enough C02 for it to 
naturally bubble up and create a head during decompres,siDn. 



Enter the widget (no, not that kind of Widget), The wadgel 
resemfiles a ping [>ong ball about 3 cm in diameter with a small 
hole 0.61 mm in diameter created by a laser. After the widget 
is dropped into an empty can, the can is filled with beer and a 
tjuick .s[u>t tjf liquid nitrogen is added. The can is immediately 
sealed and proceeds to pasteurization where It is heated lo 60 
degrees Celsius for 15 to 20 minutes and the liquid nitrogen in 
the can boils inif) gas. Tire expanding gas creates pressure of 
al^out 25 PS I inside the can, causing some of the nitrogen and 
beer, 10-15 ml, to be forced into the hole in the widget. I'he 
can and its delicious contents are then distributed to retailers. 

Strmeiime later, the Guinness is purchased and of^ened. Tlie 
pressure inside the can equalizes with the ambient pressure 
ouLside, and the lieer and nitrogen contained inside the widget 
Ls forced trut. Tire subsec]uent jet disturbs the Guinness around 


it, essentially shaking it from the inside out, and tlie remaining 
nitrogen and stubborn C02 bubble out of soiuiion, rising to the 
top to create the thit:k, creamy head Guinness is famous for. 

This seemingly simple system took Guinness 20 years and 
more than 100 failed attempts to perfect. 

Widgets are present in Guinness Ixatles as well as cans. The 
bottle widget works on a similar principle—compress nitrogen 
and beer in a plastic container and release the contents when the 
pressure changes^but is shaped like a rocket instead of a ball. 
Wiien the holllc is opened, the rrxkcl launches off the Ixjttom, 
disturbing tlie beer inside and creating the head. Each time the 
bottle is tipped back for a drink, the rocket releases a little more 
foam-producing ga,s and the head on the boule is lopjx^d off. 
And lIic rocket does have fins, not for aerodynamic reasons, but 
to keep die widget from exiting the bottle where it could be 
swallowed, hence ruining the taste of the i>eer. 

This holiday season, take a moment to salute the geniuses 
ri'Brilliantr) behind the widget when popping the top of a bottle 
or can of smooth black, ‘Iheir contribution to seasonal stress 
relief is immeasurable 


/ill 


Waterproof Camera 
Housings 

Protect Your Digital Camera From Crashes, 
Splashes, or 150 Feet of Depth 

Yeah, yetdi, tills is the journal of Macintash technology. We 
know. We also know that a laigc numlx:r of our readers arc avid 
c amera enthusiasts. Over tlie ye^irs, we f lave biought you reviews of 
some of the liesi digital aimems we have found, lb start off this 
years gift giiide^ we thought we would share with you whai weVe 
learned alx)Lil .some aimeras we have tested, bul mom inipoitantly, 
ways lo protect tliem from die elements, the ones you might find 
at the betich, cjn the slopes, or even ai the hoiiom of tlie sea, 

NoWj Michael Is an avid SCUBA diver. He's been flirting 
w'ith nitrogen narcosis since he was sixteen. Lesa is a super 
genius when il comes to making your shtjis look their 
absolute besi. Between the two {)f Lhem, you will have a very 
good idea of what cameras and cases you can get, and what 
you can do with the digital images you capture wttii them. 

Testing Conditions 

We figured the best way to stres.s test the cases we had 
would be to pick the most extreme conditions we could 
manage, and that meant diving. We made both warm and 
cold water dives, and did some .shallow water snorkcTing, to 
test the light weight cases. Following are the rigs we used, 
under what conditions, and what our impressions were. 
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Website Not Found By Clients 
HTTP 404 - Website not found 



The Equipment 


• Rent a chicken suit and stand on the 
corner handing out flyers 



The website you are looking for can't be found 
by your clients. It may have been improperly 
marketed, had poor design, or didn't work* 
Regardless, it's not helping your business! 


Your Options: 


Nikon 

First we tested the smrdy Nikon W1^-CP3 (pictured alK)ve, 
back row, right). It Ls designed for tiie Nikon Coolpbc 46(X) and 
S6(X) canienis, Ixjth of which are very capable units. You will find, 
as w'e go along, tlmi most of these aises fiave similar features. 
Clear plastic^s made of poIyearlx)natc, spring-loaded biittuas, 
slides, and wheels of differing strengdi (depending on the atse's 
depth rating) to allow you to access the control fund ions on the 
camera, and securing latches of varying design. 

Tlie Nikon case had a wheel to alk)w you to change the 
incKle of the camera, and that worried me a bit. I thtjughr ii was 
a weak point which rould allow water into tlie case easier tliaii 
a button w<juld. It was fine, though, I turned it quite a bit at 
deptli, and not even a drop slipped through. ITie huttoas an the 
case were, by necessity, clustered tightly together. Thew were 
also Ialx:led witli small pidograms on the case. Clear icons on a 
clear case made it hard to figure out which button dkl what, until 
you got used to it. Also, beouse the buttons are so close 
together, pushing the riglti one can take a bit of finesvse. Don't 
worry, , Fm not picking on Nikon; almast all the other cases 
suffer the s;mie problem. Ft’s a result of the ei>mpacL design of 
the cameras tltem.selves, and is tmavoidable. Ifs also something 
you overcome fairly quickly, as you get used to the layout, 

llie .standout feature on this case wa.s the latch. It rec|uires 
two hands to opt?rate, making it the most difficult to open. That’s 
a good feature. The last thing you want to do is accidentally 
open the case and allow the elements in. \\^ww.nikomJsa.com 

Scalife 

Oh, my. ITie first unit we tested from Sealife was Uie Rc'ef 
Master DC310 (Ixtck low, center), and it was a disa[)jx)intnient, to 
say tile least. Only 3-1 megpixel, a minuscule viewfinder, no optical 
2Dom, and a massively overbuilt case. It jusT w^asn’t elegant, tfxik 
only ^‘Dkay” pidupes, ami went ihrcntgli Iraiieries at waq> s|x.‘ed. Its 
one redeeming fc‘aluie was die case latch, l! held very well, though 
it wasn't enough to prevent it from owning the IxXtom of my ILst. In 
researching the history of digital cameras prtxluced six.‘dfically ibr 


• Paint the company URL on your chest and 
face during a major sporting event 

• Contact SharpNET Solutions internet 
marketing and web design specialists, 
watch your traffic and rankings increase, 
get great feedback from all your 

new customers* 

HTTP 404 - Website needs SharpNET 





Not Marketing Your Site? 

If you are not marketing your 
website online, you may as well 
have a 404 error for a website. 

Web Design 
Internet Marketing 
Consulting 
Lead Generation 
Multi-Media 


1 - 877 - 583-8396 

www.sharpnetsolutions.com 
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diving, we found all iiianufaLmneni in ihLs market tended to lag 
behind the mainsti'eam by one or two generatioas, easily. 

Then in September, Sealife released the UC5(X). It couldn’t have 
lx*cn moa^ of a 18(klej|ree turn around from the DC310. 'Itie 
camera itself is a very good device. It lias a five megapixel optif:al 
7XK>m, a large viewfinder, a rechargeable lottery (with better life), 
and uses secure digital memory cards. The case design was head 
and shoulders alxtve the previous version, witli a far more omipact 
de.sign, a latch as gcxxl as tlie 310, tmd access to all the functions on 
die camera. Overall, lx ah camera and case have good quality 
materials and build, particularly die case (the camera plastics ft?el a 
little flimsy)* and features that almost match any of the big vendors. 
Sealife is still a little behind the airve, but no! by mucli, for some 
features, the Reef Master ctise Ixuls out die big guys. All the bimons 
on the case are marked with gtxxl sized, color icoas, and spaced tiul 
a bit more than t^ier c:ases making it far easier to hit the right button 
(compared to some really dcn.se liuiton clusters on other nises). It’s 
much easier to hit the ri^t button, even witli diick gloves on, and 
tfiat makes a big difference. wwT¥..sealite’eamefas.com 

Sony 

We tried ou\ two difterent Sony housings, iKHh of wliicli held 
a DSC-W5 camera. Hus camera was a 5 megapixel unit, had a huge 
LCD view screen on the back (die largest of any camera we tesitxl), 
used Sony's Memory Stick, was practic'ally instaiiton, and really uxik 
OLTC of batteries. There is also a W7 7.2 megapixel version, too. On 
the aunera side, diis is a really great mcxlel to have. 

Tlie first case we put this catnera in was die SPK-WA Sport 
Pack. This is a Itghi-weight housing, good for sinilkw depths. 
Sony rates it to 10 feet, Iml we were al>le to use it at 33 fee, and 
it never leaked, even at depths greater than that. Not uxi shaljby. 
Everything about this case is the same as the next Sony case, 
except the thickness of plastics. As it is not designed for serious 
depth, its case is thinner than some of die oiliers. This makes for 
a lighter, and slightly smaller case than the others (in fact, all of 
die cases for shallow depth are similar in this respect). 



Shot taken using the Sony Sport Pack. 


That other Sony case we tested witli die DSC-W5 was die 
MPK-WA Marine Pack (front row, right). It has thicker 
polycarbonate plastics than the SPK-WA in order to support 
its 40 meter depth rating. It shares many of the features of the 
Sport Pack, as w^ell as most other cases, such as the Iiurton 
cluster on the back, the shutter and power buttons on top, as 
w^ell as a wheel to control the camera mode change. The 
control wheel, like the one on the Nikon, works just fine. No 
leaks. One nice feature of the camera w^hich makes changing 
modes super easy wdiile in die Marine Pack is diat it shows a 
circle of the mode icons on the LCD display spins diem, and 
highlights the active one as you turn the wheel on the case. 
It's dead simple to change the mode on tlie Sony camera with 
that feature. 

The only thing 1 am not fond of on these Sony cases is 
the latching mechanism. Tfiough it never failed on me, 1 
always had the concern in the back of my mind that it was 
going to pop open, or 1 was going to accidentally unlatch it 
while operating the camera. The mechanism latches securely, 
but opening and closing it is very easy to do wilh only Iwti 
fingers, hence my concern. 1 don’t consider it a deal breaker, 
liccause on the whole, Ibis combination is excellent. 
www.sonystyle.com 

Olympus 

Like Sony, we liad two Olympus cases to try out. The 
first was the PT-027 case, designed to enclose the C-7070 
camera. This combination wa.s huge. 'Hie C-7070 is an SLR 
sized unit, with 7.1 effective megapixels, and 4x optical 
zoom. It's big. Putting it in the PT-027 case made it even 
bigger and very* unwieldy. This rig was difficult to use, 
e.specially underwater Operation was a two-handed 
proposition, without exception. If you are looking to get 
serious about your underwater photography, you can do 
betlLT than this. Ltxik into film and tlie Nikonos V camera rig. 
IPs the gold standard for jirodevel phouigraphy of this type, 
and ha.s been for many, many years. 

The tithcT Olympu.s case and camera combo we tested 
was the PT-026 case (front, center), whicli can house the 
StyiiLs 500 camera. This case is pretty decent and shares 
features with eveiy other Olympus case for their other digital 
camera offerings. Rated to J30 ft., it was made of clear 
plastics, had the usual button cluster, and a decent latch 
mechanism. The one stanctau feature on the Olympus ca.$es 
is the shutter button. It is a big, levcT-{ipeFaied contraption 
that is very easy to operate under any conditions. 
w'ww.olympu.samericaxom 

Camera Shield 

Here's an interesiing product. We spent some time surfing 
the intcmci to see if we could come up with anything not 
widely known, or with a lot of presence, and found ihe Camera 
Shield by Foerte Cases (front row, left in the collage above). It’s 
essentially a lx)x. Sporting a single opening, one .side comes 
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completely off, through which you can place akiiost any 
caniera yt>u warn, it also has one coniroh an adjustable lever 
to activate Che camera shutter. The side of die Ixix is held on 
with two latches, which are secured with an o-ring stretched 
between them. This case is utterly simple and totally brilliant, 

There arc two versions: one with an orange removalde 
side for deep w^ater, and a yeIlo%v side for a depth of 10 feet 
I’m not really sure what the difference is besides color, because 
all the parts lcK)k the same. The yellow sided box worked jtisi 
fine at deptli, too (1 used it on deep dives twice before i 
reali^^etl I hatl the wrong box). There is one thing to kee]") in 
mind when deciding on a Fuerte case; If you are pulling your 
own camera in it, make sure its tliickness won't be a problem, 
rhis case compresses the rleeper ii goes, so you need some 
wiggle room inside. 

Don‘I woity if you lack a camera of your own to pui in 
the box because the Camera Shield comes with its own. It's 
a basic 3.H megapixel, camera, no optical zoom, with decent 
use of battery power, it accepts SD memory cards, and takes 
surprisingly good pictures. It's a nice addition to this very 
reasonalile case. ww'wTnertecases.coni 



A surface picture taken with camera that comes with the 
Camera Shield. 


Caiion 

We had ihe opportunity to try out one case from Canon, the 
AW-DC30 (]>ack row, left side). It is a case designed for 
protecting the camera from splashes and shallow' deptlis. It is 
rated to tmly 9*8 feet. Unfortunately the ca.se didn’t even hold up 
that much. A slider seal on the back of die cuse, ilirough wliich 
you change the mtxle of the camera, failed, flooding the case in 
less than 5 feet of water. 1 was literally floating on the surface, 
holding tile camera imderncath me, when water started to leak 
in. Setting that aside for the moment, however, the feaaires were 
fine for this type of protective case. WeTe just not at all sure 
alxjut iliat ,seal <wer a sliding .switch thing. It seemed an easy 
failure point. Your mileage may vary, ww^v^canonusa.com 




Image of a spotted eel, taken off Maui (unretouched). 

In the Computer 

Underw^aiCT images ait notorious for dieir blue/gften toltir 
casts, so color a^nection Is a mu,st (mKict the giten aist on the above 
image of an eel). No matter which im;ige etliting software you use, 
ciop tlie pliolos to tlieir subject matter lirsi. 1 started oui in il^hoto 5, 
where llie Edit > En!i;mce tool fxxxiuced surjmsingly decent results. 
I clicktxl the Adjust button and, from tJieir starting pf.xnrs, Ixxisred the 
Saturation, lowered tlie Tint, and increiistxl tlie Sharfxn slider a hit, 
just for kicks. Tills gave me veiy a^asonahlc resulis. 

For serious photo editing fun, you’ll need to cx^zy u]:> to 
Ph^itashop or Phot(xshop ElenienLs. In eiiher program, use a 
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Thitshold adjusiincni layer lo *snilT oui wliich hiLs of iliu plioto are 
supjxxscd to black and wliite* Drag the Threshold slider to the left 
to find the bLickesi blacks, and right to find the whitest whites. 
Remember those spoLs and use them to set black and white points 
in a Curves adjusunent layer 1 also raised the center of the curve 



A Pacific Nettle jelly, taken off Santa Cruz Island, CA: 
before and after (done in Photoshop). 


ever so slightly in order lo brighten the overall image. Last but 
not least, apply an Unsharp Mask, I went one step furtlier on 
some of the surface images and boosted the saturation of the 
blue channel by adding a Hue/Saiuralion adjusUneni layer. This 
is a great way to bring out the brilliant blues of an ocean. 

Decompress 

There you have it. Our overall favorite, by far, was the Sony 
DSC-W5 SMH (and -W7 7.2MP) aimera, and MPK-WA Marine l>ack 
housing. Tliis a^mbinadon pnwided ilie Ixr.st overall combination 
of features, usability-, and quality of all die rigs we tested. If you are 
in the market for a complete set, either for ycxirself or as a really 
aK)l gift, Sony is the way to go. 

TliaPs not all diere Is to it. lliough, A couple of honorable 
menfions are needed here. 'Ihe Sealife Reef Miister DC S(X) is a very 
good option if ycHi have a SCUBA drver on your ChrisiTnas list. As 
an all in one solution at a reasonable price point, you really can‘t 
go wrong. Alternately, if you have someone who needs something 
to start with, or already has a camera and only needs something 
simple, die Fueite Camera Shield is a very grxxJ 0 [>tion. Simple and 
easy to use, iPs also a good gift for the occasional diver, lx>atet; or 
beach goer who wants .something cjuick and easy. 

Keep in mind two things: One, except for generic cases like 
the Camera Shield, you need lo be sure to get a case specifically 
designed for your camera. The tolerances inside, and the control 
plac-cmenLs really don’t let you stick one c’amera in anodier case. 
Two, remember that just about every mainstream camera 
nnLanufacturer has a line of water proof cases for almost all the 
cameras they sell, with varying degrees of strengdt.. Few- 
companies seem to market tiieni very well, if at all, and you'll 
have to dig through their web sites to find them. One other thing 
to note is that manufacturers only seem lo keep cases for the very 
latest models on liand, even if tliey still have older cameras 
available. They don’t seem to keep 



A favorite shot from all the work done on this review 
(retouched in iPhoto). 


them in the main inventory for very long. Don’t worry, though 
as you can find cases for most any camera out there on various 
sales sites, or eBay. We found many coses dt>ing a searcli on 
shopzilla.com. No matter where you get the case from, it will l>e 
a very welcome gift this holiday season. 

Very special thanks to Pete Sebastian and Seth, Benja 
Iglesis and Makena Coast Dive Charters, the Vies and 
Extended Horizons (all on Maui), Peace Dive Boat (in 
Ventura, CA), and lust but not least, Blessy and tlie folks at 
\Mk\i Scuba (also on Maui). We couldnT liave abused lliese 
t:ascs properly, nor found the .shols witliout your expert 
guidance. Also, my undying appreciation to Kellee and Larry. 
Thanks for everything, 

Viti 
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APPLESCRIPT ESSENTIALS • by Benjamin $, Waldie 


1 Building a Table View 


PRojEa IN AppleScript Studio 

ack in my April column, I provided an introduction to 
AppleScript Studio, a technology that is a part of Xcode and 
Interface Builder, Mac OS X’s powerful integrated development 
environment. Using AppleScript Studio, AppleScript developers are 
able to create fully native Mac OS X applications, complete with user 
interfaces. By constructing scripts witli interfaces, developers can 
build complex and powerful user friendly AppleScript solutions that 
have the same look and feel of any other Mac OS X application. 



In addition lo building stand-alone AppleScript 
stjlutioas, AppleScript Studio can also now be used to 
create Automator actions, for u>se with Mac OS X 
10,4’s populiir new Automator application. In my 
August coluinn, 1 walked through the process of 
building of a simple AppleScript Studiod>ascd 
Automator action. 

This month, we will create a new AppleScTtpt 
Studio-based project that is a little more ccHTtplex, atid 
incorponites a table view into its interface. I'his 
application, which t call Emibie\Dimhie Mail 
Accounts, will display a list of email accounts in Mail 
to the user, and allow the user lo itjggle whether the 
accounts are enabled or disabled. 

Table Overview 


Before we get started, 1 would like to briefly 
discuss the concept of tables. In AppleScript Studio, a 
table, which is actually referred to as the class table 
view, may Ik" used to display a list of retxirds, 
complete with field values, similar to what you might 
see in a spreadsheet. See figure T 
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Figure T. An Example of a Table View 

While a table view can be placed onto an interface 
wmekw, or any type of view class for that matter, within 
AppleScript Studio's class hierarchy, a ia!>le view' is actually not 
a direct element of the windtm' itself Rather, it b an elemeni 
of a sc roll view, which typically is an element of the window. 
Because of tMs, when referring to a table, you must do so 
within its parent scroll view. For example: 

table 1 of scraXl view 1 of window I 

Much like a spreadsheet, a table view imy i>e configured to 
display multiple rows of data, in one or more columns. When 
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IX)puliitin^ or manipulating the contents of a table view, the 
preferred and suggested method of doing so Is rhrouglt the use 
of what is known as a data source. A data source is esseniially 
equivalent to a virtual database within your AppleScript Studio 
project, complete with records and fteids tliat can hold the 
values for your table. A data source, wliicfi can lx,‘ created up 
front in your project, or dynamically througli AppleScript code, 
may hf^ linked to a ta!>ie view. Once linked, the table view's 
visual contents on the window will auiormtic-ally rellect the 
contents of the data source. So, in otlier words, as ytju make 
changes to ilie t^ontents of the data source, those changes w'ill 
autojuarically translate directly to the linked table view. 

There are other ways to populate and manipulate data 
witliin a table view* without creating or intemeting wiili a data 
source. 1 won*t Ix! covering those methods in this month's 
column, but 1 want you to l)c aware dial there are multiple ways 
of accoinplislung the same goal when working with table views. 
However, as 1 said fjefore, using ibta sources is the preferred 
metliod of populating a table view, as it is typically the most 
efTieient and has some lienefits that other metiuxLs do not. F<jr 
example, when using a dam source, it is passible to suspend 
updating of the table view during modification of the data 
source. This updating can then l>e re-eiial>lcd once the data 
source Ls finished fxhng modified, thus allowing the table view's 
display to update all at once. 

Working with table views, sctoU views, and data sources 
can seem complex at first. As we proceed tlirough the 
reiruiinder of this month's column, hopefully, these classes will 
begin to make more sense to you. However, for more detailed 
overviews f>f these classes, you may want to coasult the 
AppleScript Studio Temrmo/fig)' Reference, which is included 
with Xcode's documentation, and can also be found in the ADC 
Reference libniry^ on the Apple Developer Connection website 
at http://developeLapple.com/ . 

Now, let's get started on our project. 

Building the Project 

'Phe First step in btiikling our project is to create a new 
AppleScript Studio project. As always, begin by launcliing 
Xcode. Please note that, for this column, my project was 
developed using Mac OS X 10.4.2 and Xcode 2.L That .said, the 
code included in this column may or may not function in older 
versions of tlte OS and Xcode. However, please be aware that 
new software versions often result in elmges in AppleScript 
terminology. Therefore, if you are using software versions otlicr 
than those that I liave specified, your required terminology may 
differ slightly from that which I am using in this atticle. 

In Xcotle, create a new projea, by seleaing Neu^ Pni^jevL.. 
from the Fik menu. Wlien prompted, selea a project type of 
AppleScript Application from the list of available projea 
templates, specify a project name of Enabte\Dmihte Mail 


Accounts, and specify an output folder for die project- Xctxle 
will duplicate die AppleScript Application projea template into 
the specified output folder, and open it I before you. See figure 2. 



Figure 2. Enable|Disable Mail Accounts Project Window 


Building the Interface 

The next stefi in ilie creation of our AppleScTipt Saidio projea 
will lie to design the interface. To do tliis, double clic'k on the 
MainMettujiih file within your Xcode pmjea window. Tills will 
oi^en ilie projea's default view in the Interface Builder application. 

Designing the Window 

By default, the projet.t s interface .should already contain an 
empty window view. Tljis window will lie the ba.sis for our 
interface. Click on the window, and give llie windtiw a name 
by entering Enable {Disable Mail Accounts into the Wirulow Tille 
field in the Inspector palette. See figure 3. If the Inspector 
palette is not visible, simply seiea Shtne Inspector frtim the Tools 
menu in Interfac:e Builder. 
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Figure 3, Assigning a Window Title 

While the window^ is sull selected, also de-selea the Visible 
al Launch Time checklxix, if it is selected. 'Hus will cause tlie 
window to be hidden when tlie projet:i is first launched. Ibis 
means that, later, we will need to add code to display the 
liiddeii windowL The reason we want it to be hidden initially 
is so that we can jx)pulate a lalile view with dam, prior to 
displaying the w^indow. 
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Ncxt» click on the Cocoa Data Views mb in the tfK>lbar of 
die Paiettes window. If the Paiettes window is nol visible, select 
Paiettes > Show Paiettes from the Tmyis menu. Next, locdte an 
NSlahteView interface element in the Palettes window, and drag 
it into your projea's window- See figure 4. 



Using the Inspector palette, configure the scroll view to 
contain two columns. Next, double click on the scroll view to 
select the table view element. Finish preparing the table view 
by clicking on each column within the table view, and entering 
header titles of Account Name and Statt 4 s for the column 
headers. See figure S for an example of how tSie talile view 
should appear, «>ncc it has lieen configured with two columns, 
complete witii column headers. 



Figure 5. Assigning Table View Column Header Titles 

Next, click on die Cfkroa Controls and inetkators button in 
the toolbar of the Palette window, and dnig two hunons into 
your interface window. Fnter Quit and To^ie as the titles fur 
these buttons in ihc Inspector palette. 

Arrange the interface elements in the window', and make 
any necessary adjustmencs until the window resembles the 
example shown in figure 6. 
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Figure 6. The Complete Solution Interface 


As you design an interface, always try to adhere lo Apple's 
standards for human user interface guidelines, v^iiich can )>e 
found in the ADC Reference library, lx>th online and in 
Xc( ide'.s dt HTumc nia tion. 

Preparing the Interface for AppleScript 
Interaction 

Once you have finisheti designing the interface, the 
elements ihat make ii[) tlie inlerhice must lx- prepared for the 
Af)t)leScript code within your project to interaci with them. This 
task will consist of assigning AppleScript names to various 
interface elements, as well as configuring certain elements of the 
interface lo respond to event handlers. 

First, we will assign an AppleScript natne to the main 
window' itself. To do diis, click on the window to select it. 
Next, choase AppleScript from the popup bum>n at the lop of 
the inspector j:)alette, and enter the name Main Window into the 
Name field. See fig\ire 7. The pnx'css of assigning AppleScript 
names to other interhice elements will lx- the same. 


O Q Q NSVWndw Impegor _ 

AppleScript > *} 


Name: Mam Window Index: 0 


Figure 7. Assigning an AppleScript Name to the Main Window 

Next, select the Quit and Toggle buttons that were 
placed on your window, and assign AppleScript names of 
Quit and Toggle to these buttons, respectively. For each of 
these buttons, we will also a.ssign an event handler. A listing 
of the event handlers to which an interface element can 
respond are located on the Inspector palette, beneath the 
Name field. Vm these two buttons, enable the clicked event 
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handler by selecting the appropriate checkbox. You will then 
need to link the event handler to the AppleScript file within 
your project code. So, select the checkbox next to 
Enuble\Disable Mail A€counts.al}}}lescri}}t^ in die Script area 
at the bottom of the Impvctor palette, beneath the event 
handler list. See figure 8 for an example of a properly 
configured button. 



Figure 8. Configuring a Button 


Select the scroll view in tlie window, and assign an 
AppleSiTipt name of List to the scroll view. Next, 

double click on the scroll view to select tJie enclosed table view, 
in the Inspector palette aj^in, assign an AppleScript name of 
Account List to the table view. Also, enable the Awake from 
Nib event handler for the table view, and link it to the 
AppleScript in your project. See figure 9. 



Figure 9. Configuring the Table View 
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With the table view still seleaed, click on each of the 
Account /Vame and .Status column headers, and assign 
AppleScript names of Account Names and Status to each of 
these headers, respeaively, using the /ns/jector palette. No 
event handler assignments are nece.ssaiy for tliesc elements. 

Finally, as a last step in configuring the interface, select 
rite's Owner in the MainMenu.mh window, enable the 
launched event liandler, and link it to the AppleScript in your 
project, using the Impeclor palette. See figure 10. 



Figure 10. Enabling the Launched Event Handler for 
the Solution 


Adding the AppleScript code 

Now that you have configured your interface, return to 
Xc'ode again, as it is time to liegin adding the AppleScript code 
into your project. Double click on the i:nabk\l>isable Mail 
AccountsMpplescript file in your projet t to lK‘gin editing the 
AppleScript code. 

Building; the Data Source 

'I'he first AppleSt:ripL ctxle that we will add to the pmject 
will Ix^ code that creates a data source, wliich will later lx 
populated to update our table view's contends. We want this 
code to be triggered automatically, prior to liciually displaying 
the interface, Tlierefore, ft) do tliis, we will make u.se of the 
awake from nib handler, which will Ix triggered by ilie 
project when the interface is first kjaded. 

Type tlio following code into your project: 

on awake fro^ii nib tbeObject 

set tKeOataSource to fiakc new data source at end of data 
sources with properties (name;’'Account Data^l 
tell theDataSource 

make new data column at end of data columns with 
properties Inane:"Account Mane"! 

make now data colunn at end of data columns with 
properties tname:"Account Status"! 
end tell 

EG! data source of thcObject to theOataSonree 
end awake from nib 


The first line of code within this handler wWl create a new 
data source, named Account Data. The next few lines will 
create columns for the account name and status within this data 
stmree, to match our table view configumtion. 

In our interface, we configuretl our tabic view witli an 
awake from nib event handler. Therefore, when this liandler 
is triggered, a reference to the table view wiU be pa.ssed to the 
handler in the parameter named theObject. The final line of 
code within the handler w'il! set the data source property of 
the table view to ilie newly created data source, thus linking the 
table to ihe data source. Once linked, any changes we make to 
the contents of the (km source will lx redcctcd in the table view. 

Refreslimg the Table 

The next code wx will add to our project b a aistom 
handler, which I have named refreshAccountListing. 
Thb liandler will be allied by other code within our project, as 
you will see shorlly. llie responsibility of this code will lx to 
populate the contenm of the data source that will lx built with 
the previous code we discussed. 

Type the following ccxle into your project: 

on refrGsMccountListlng{) 
tell application “Hail" 

SGT theAccoiuitNaineLlat to name of every account 
eet thRAccountStatusLlat to enabled of every account 
end tell 

tell data source "Account Data" 
set update views to false 
delete every data row 

repeat with a from I to length of theAccouniNameList 
set theRow to make new data row at end of data rows 
tell theRov 

set contents of data cell "Account Name" to item a 
of theAccountNameLlat 

if item a of tbeAccouniStatusLlSt “ true then 
set theAccountStatus to “Knabled" 
else 

set theAccotmtStatufi to "Disabled" 
end if 

set contents of data cell "Account Status" to 
theAccountStatus 
end tell 
end repeat 

set update views to true 
end tell 

end refceshAccountListlng 

This handler will first retrieve the names and staiuses of any 
email accounts in Mail, Next, the handler will tell die data 
source lo set its update views projxrty to a value of false. 
This will actually cause the talile view ttJ cease updating 
temporarily, while the data source is IxHng modified. 

Next, the handler pnxeeds to delete any existing data rows 
from tile data source. Within a data source, a data row 
represents a single r>w of data witliin the table. A data row 
contains data cells, wliicli are essentially fields to hold the 
data, which translate to the colujnns wliiiLn a table view, llie 
reastjn we want to delete the data rows wirhin the data source 
first IS Ixcause we will trigger this handler any lime we want to 
refresh the t:ontents of the data source. Before doing this, we 
need to delete any existing rows that may have Ixen previously 
created, so that die data sourc'e is a^mpletely refreshed, and new 
data b simply not appended to existing data. 
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After deleting any existing data rows, the handler will then 
loop through the retrieved entail account names, and create a 
new data row for eaeii, inserting the account name and iLs 
corresponding status into the appropriate data cells for each row. 

Finally, the update views propefty of the data source is 
set to a value of true, allowing the table view to update to 
reHea the new contents of the data source. 

Initializing the Table 

Next, we are going to add ilie code iliat will initially trigger 
the ref reshAccountLi sting handler to populate the data 
source. Once populated, this code will also make the main 
window visible to the user. 

i'ype the following code into your project: 


on clicked theOhject 

if name of theObJect ” 'Toggle" then 
toggleAccounts 0 
else 
quit 
end if 
end clicked 

If you recall, we applied a clicked event handler to 
each of the buttons in our interface, ilierefore, this handler 
will be triggered whenever the user clicks one of those 
buttons. This liandler will check the name of the button that 
was clicked. If it was the Toggle button, then the handler will 
trigger the toggle Ac counts handler, if not, it a.ssumes 
that die user clicked the Quit button, and it simply quits the 
application entirely. 


on launched theObject 
refreshAccountListingU 

set visible of vindow "Main Window" to true 
end launched 

This launched handler will t>c triggered automatically 
when the project is urn, immediately following the successRil 
execution of the awake from nib handler. 

Toggling the Email Account Status* 

Next, we need to add code to actually toggle the status of 
any selected emai! account.s in the table view. To do this, type 
the following code into your project: 

on toggleAccountaO 

set theSelectcdRows no R^lected daia rowi? of table view 
"‘Account List” uf scroll view “Account List” of window "Main 
Window" 

repeat with a from 1 to length of theSelectedRows 
set theRow to item a of theSelectedRows 
tell theRow 

set theAc count Maine to contents of data cell "Ac count 

Name” 

set LbeAccountStatus to contents of data cell "Account 

Status" 

if theAccoimtStatus - "Enabled” then 
set theKewAccountStatus to false 
else 

set theNewAcconntStatus to true 
end if 

tell application "Mail" 

set enabled of account theAccountMame to 
theNewAccountStatus 
end tell 
end tell 
end repeat 

refreef3AccountListing,( J 
end toggleAccounts 


This handler will lie triggered wlien the user dicks the Toggle 
button in the interface, It will retrieve a listing of any .selected 
accounts in the table view, toggle the sTatiis of those accounts in 
Mail, and then trigger the refreshAccemtListing handler to 
update the table view to reflect the newly modified account 
statuses. 

Adding Button Code 

Finally, we need to add code to perform the appropriate 
task wlien a imiion in the pnijeci’.s interface is clicked. To do 
titis, type the following code into your project: 


Testing the Project 

Now^ that our projecr is complete, it is ready for testing. To 
test the project, select Btiikl and Run fmm llie Build menu in 
Xcode. If everything works as expeaed, your solution should 
launch, and the interface should be displayed, complete with a 
table view showing your Mail account names, along with their 
statuses. See figure 11. 



Figure 11. Tlie Completed Application 

Select one or more accounts in the table view, and click the 
Toggle button to verify that the account statuses are toggled in 
Mail, and the project (^mperly functions. 

In Closing 

AppleScript Studio provides many possibilities for 
creating interfaces. As you can see from this relatively 
.simple interface, with the use of ia[>le views, you can 
construct interfaces for your AppleScript Studio projects 
that will display information to the user in rows and 
columns, and even allow a user to make selections from 
this data. 
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For example, a talkie view might list file names, email 
addresses, database fields, etc. The possibilities are virtually 
limitless. Wliat‘s more, yem can even extend the functionality 
of table views further by adding embedded buttons, 
checkboxes, and more to the columns within the table view. 
See figure 12 for an example nf this. Using this type of 
technique, we could update the Enable \Disable Mail Accounts 
project to allow a user to toggle email account statuses by 
making ,selections from indivkUial popup menus, rather than 
clicking a Toggle buttoiL 
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Figure 12* An Example of Embedded Interface Elements 
within a Table View 


Plea,se note that 1 have made the sample project discussed 
in this article availafjle for download from my wei> site at the 
following URL: 


http://www.autQmatedworkflows.com/files/demQs/MacTECH. 12 

.O^.Exampie.zip 

I encourage you to continue exploring table views on your 
own, and expanding the sam[3le project di.scu.ssed in tlii.s 
montlVs column to include even greater funaionality. 

Until next time, keep scripting! 

'Jill 
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What’s Rattling 
Around in my sed 

Automating edits. 


S X is Unix” - a statement that has been under a bit of debate 
since the OS sliipped. It does look like a duck and does 
smell like a duck, but it doesn’t really quack like a duck. 
Wliile many, many projects will, unmodified, compile and mn under 
OS X, there are enough that do not thanks to the acrobatics that OS 
X engages in underneath it all. 'fhat’s why we all have to delight in 
any project that comes pre-installed for us - no compile necessary, 
and we know it’ll be on all OS X boxes that we touch - and runs 
identically to the Solaris/IRIX/Linux/HP versions. There are two 
indispensable utilities that fall into this category: sed and awk. flaese 
will consume us the next few columns. With sed (“the stream editor") 


being tire more simple of the two, tliat’s where we’ll start. 


Cuckoo for Cocoa Puffs! 

OK - it’s nor that kin<l of cereal! seel is a ".serial 
editor” as in it will re[>eaiedly make changes to an 
input stream in series. 1 was, not all that long ago, 
amongst a group of like-minded Mac techs and one 
person asked how lie could take a single file and alter 
it many times over for specific destinations. I 
immediately offered sed as a solution. “^WhaT?” "sed,” 
1 repeated. Blank stares, sed and awk are too Liseful 
to not Lise! 

sed takes input, via file name or standard input, 
prcK^esses the file and pumps the re.suILs [>ack via 
standard out. However, instead of making edits 
interactively, like you might with vi or a word 
processor, sed allows you to script your edits, ainuhst 
as if youVe creating a macro. This script can then be 


applied to many (or, any) files. Just like your editor has 
commands that will iii.sert a line, delete a line and so on, so 
dt>es sed. Even more impressive, is sed's ability to alter a 
file, or stream through substitution and regular expressions. 
And there’s the rub. We can 1 talk about sed witliout 
talking about regular expressions (RE). 

Lucky Charms 

Regular expressions are fundamentai to the Llnbc 
landscape; Understanding them makes your computing 
life better and easier on many levels. Even many CUT 
editors have support for RE built in. Notable examples are 
BBEclit and Dreamweaver. 1’here are patterns that yon can 
describe with RE that just canT he done cleanly otherwise. 
A full discourse on regular expressions is its own ankle or 
even book. Fortunately, there's plenty of material out 
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there. The Pebruary 2005 issue of MucTech ran, 
"MatchmakiJig With Regular Expressions” by Paul 
Am man n, so if youVe been a subscriber^ or have tIuU issue, 
you should start there. O'Reiliy has an entire book on RII 
alone called **Mastering liegular Expressions.’’ If you've 
already mastered RE, please skip ahead to the next seciion. 
Otherwise, Em ready to present the %vor]d's shortest intro 
and tutorial on regular expressions. 

Regular expressions are one of tliose things that can 
l>e a little daunting at first, because the syntax is a lillle 
out of tlie ordinary, llow'ever once you dive in, youll 
start seeing patterns everywhere that are a great fit. 1 wall 
admit that I’m going to gloss over some of tlic finer details 
regarding RE. 

A regular expression is just that: an expression. It's not 
to tie taken literally as it is by itself. This is because most 
patterns involve inetacharacters. We all intrinsically new 
understand the wildcard metacharacter, If we were to 
type into our shell, “Is -1 we'd expect a listing of all files, 
as we're not literally looking for a file named Sijnilarly, 
seel is heavily clepenclant on metacliaiacters in Rp]. Also, as 
an expre.ssion, it is .something that the Interpreter evaluates, 
much like a inaiheniatieal expressitm. Since understanding 
how^ the interpreter evaluates each metacharacter is 
fundamental to ycnir under.standing of the concepts covered 
in I his pieat that’s where we ll siart. 


Non-metacharacters are matched verbatim. If you ask 
sed (or grep) to match '‘Cat”, it will match a capital “C” 
immediately followed by a lower case “a”, adjacent to a 
“t". No other permutation will match. Each character is 
its own RF. that matches that single character. To match 
any single cluiracler, use the (dot) meUi. So, a regexp 
of “ca.” w^ould match “cat” or “cab", but not “rat". To 
match a wider swath of “any” characters, use the wildcard 
(asterisk). The asterisk behaves a liulc differently Uian 
you may think. It modifies the previous character, and 
matches zero or more characters. Again: it modifies the 
previous character. If you are looking for “car", a RE of 
W" w ill not do what you expect. Yes, it will match “car”, 
but will also match any w'ord with “r” in it. Huh? “cV 
says, “match zero or more of the letter c, and then an r." 
That re-enforces the second point: it will match zero or 
more characters. To find words that begin with “c” and 
end with “r”, yon can use “c.*r", which wall match “cr” (if 
that was a w'ord), “ear" and “cur”, but also “choir”, “czar”, 
“carpeunonger”, “calcaneo])lantai”,,.and much more, as 
we’ll see. 'Phis .says, “match the letter zero or more of 
any character, and then an T'”. 

Well, if you actually ran the al>ove on a dictionary file, 
you'd notice that you’d get a lot more that expected, i low 
does “c.’r” matc:h “buckarcK^”? We need to learn two more 
nietacliaracters: begin ning-oEline “A” (circumflex) and end- 













of-line **$” (dollar sign). So, to truly get words that begin 
with and end with youM use a RR of “Ac^*r$^ Tliat 
says, '‘at die beginning of the line, look for a *c\ then match 
zero or more characters, and finally match an 'r' at the end 
of the line.” 

Cheerios 

l^t's jump right in with an example, shall we? Probably 
tlie sed cormiiand (or, mnemonic) used most ollcn is 
substitute - 

sed -e 's/Mike/Kichael/■ letteL.txt 

This tells sed to run through the file letter.txt and replace 
'Mike' with 'Michael'. Note the use of the forward slash 
as a delimiler. However, if you read the preceding 
section, you may have come to expect that ids never 
quite that simple. Tlie substitute command will only 
make the subsLiLution for the first <>ccurrence on a line, 
unless you add the global flag - Simply, the 

command should be: 

sed -e ‘s/Mike/Michael/g' ietter.txt 

'fhatH get all of them. You can even make multiple changes 
in a file: 

sed e * s/Dot/DorQtiiy/g' e * s/Chrls/Christopher/g' 
personnel.txt 

This gives us an i>pporLynily to talk about liow sed applies 
edits, which is critical to understanding wliat's going on. 


sed works with a line diat it brings into its pattern space. It 
then applies all edits that youVe asked for to dus line, moves 
tlie ufxlated line to stdout (if appropriate), iincl tlien brings die 
next line into die pattern space. To really understand tliis, a 
denionstnjtion is in order "Ihe following text Ls in a file c:alled 
'shoit_story.txt’: 

tiill and Michael went to the store. Bill needed to buy 
some butler, eggs and Hour. He and Micfiael were in a 
liuny to Ixike a cake for their parent's Anrdversaiy. Once 
diey got home, Bill and Michael realized diiit tliey forgot 
cake icing. 

Of course, Mich^iel, teing the older brother, f^ls he should 
precede Bill in die story. Well, yt>u iiave sed and dial's an 
easy task, right^ Wlierever you see 'Michael', cliange it to 
‘Riir, and wherever you see 'Bill', change it to 'MickieF: 

$ sed -e ' s/Bill/Klchaei/g' -e * s/Miciiaei/Blil/g' 
Ehort_story.txt 

But wlien you run the command, you get this output: 

Bill and Bill went to the store. Bill needed to buy 
some butter, eggs and flour, lie and Bill were in a hiiny 
to bake a oke for their parent's Anniversaiy. Once 
they got home, Bill and Bill realized that they forgot 
cake icing. 

What liajipenecP Let's trace: 
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1. sed brought the first line into pattern space, 

2. sed found the pattern ‘Bilf and substituted 'Mtchaef, 

making die line: 

'"Michael and Michael went to the store, Michael needed 
to buy'' 

3. sed then applied the second edit we asked for, making 
'Michael' into 'Bill', resulting in the output we just saw. 

lie aware of that Interaction, Later on (read: next monih^s 
column), 111 show how to deal with dial. Using llie 
simple substitution above is great static files, like a 
checklist: 

Hello -*^flrstname='! Welcome to Acme and Associates, 
Tliere are some things you* 11 need to know to get 
started with our network. Please keep a record of 
these Items; 

Name; -"username-- 
Pho n e; *“phon e num"- 
TP address: ipaddr*’ 

Thsnksl 

You could write a sed script that alters this file 
appropriately before mailing it oui. Of course, substitution 
gets much more interesting when combined with regular 
expressions. But first, we need to look at some of the 
other sed commands. 

Rice Krispies 

A,s mentioned, sed is an editor. What good would an 
editor be if it couldn’t add and delete lines? The simpler 
of the two is delete. Delete erases the entire pattern space, 
and then continues on to the next line - lhere\s nothing left 
to match after that, 

sed € 'Id' ithort_atory_tjrt 

This prints out our short story, minus the first line - that gets 
deleted. Of course, delete Is even more powerful when 
combined with regular expressions. How about one Uiat gets rid 
of bash comments: 

sed e baehscrXpt.sh 

To create more complex sed interactions, we can put 
all of our conuiiands in a file to make a sed script. By 
placing your edits into a sed script, you gain the advantage 
of making your routine reu,sal>]e, and l>eing able to build it 
up slowly - these scripts can get complex very quickly, and 
it's not often that you get it 100% right on the first shot. If 
you were ro save the following into a file named 
"editscripi.scd”; 

Id 

s/Bill/Wli Ham/g 
s/cake/pie/g 


you'd ]>e able to run it against our short story, using the 
r flag, and see each edit: 

$ sed -f editscript.sed short_stery.txt 

some butter, eggs and flour. He and Nlchael were in 

a burry 

to bake a pie for their parent's Anniversary* Once 
they got 

home, William and Michael resli^ced that they forgot 
pie icing. 

First line deleted, “Blir becomes "Williatn” and “cake” 
becomes "pie". Using a sed scrij>t also brings some other 
advantages in terms of opening up other commands for our 
use. First and foremost, as opposed to delete, we can 
insert. Insert is one of the t>dd sed commands in that it 
expecLs its input lo he broken up over more than one line. 
If we wanted to insert a title at the top of our story, we 
could use this: 

li\ 

The Wedding Cake 

With inseit, you musl include a liackslash after the 
t:ommand with tlie text Co lie inserted on the next line. 

Also, within a sed .script, we can use functjt>ns. 
Functions in sed^ Well, perhaps they're not like tmditional 
fiinctit>ns, but we can opt for a series of edits to take place 
on a sub-set of the tlocumeni we're editing; 

Bill/ I 

^/Bfl1/William/ 

/ / 

(note here that the second edit is “s slash space space 
space space slash iiib slaslT. Thank you for your 
patience.) 

This tells sed, '"only on lines that start with four spaces 
immedialcly followed by diiir will you make the following 
edits: change Bill to William and then change four sjm'es to 
a tab character" Think of all tlie ctmditional ways you can 
program edits with this feature! COK, did 1 get too excited 
over that?) 

Again, the power of regular expressions increases 
sed’s value exponentially. This is especially effective 
when dealing with any kind of mark-up. And to make 
this even more powerful, we need to introduce 
addressing. So far, our commands have not had an 
address, which makes sed apply edits to each line* 
Another po.ssibility is io supply one address* This can 
come in the form of a number, or a pattern* if we only 
wanted to make substitiitions on lines that end with a 
period, we could use something like this: 

sed -e '/V*S/s/\*/!/g' short^atoty -Lxt 
(The address to affect is in bold) 

This tells sed, “only on lines that end with a period 
- we have to escape the period, otlierwise it’ll match any 
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single character), substitute an exclamation point for any 
period on the line.” OK, it's a completely contrived 
example, but it should convey the power this brings. I 
used a not so contrived example tlie day 1 finished this 
anicle. T was working on a mailing for a client (not a 
spammer), that needed to retrieve their client e-mail 
addresses from a Crystal Reports CSV file. CR writes 
caimmy CSV, only enclosing fields in quotes if they 
have an embedded comma. While that's valid, the 
software this client was using for mailing didn't like 
that format loo much, scd to the rescue! Here's what 
I did: 

$ sed V^Ws/,/ /V ciients,c:sv > ciienLs2.csv 

Tliis told sed, "only on lines that begin with a quote (gotta 
cscaj>e the quote there), substitute a space for the first 
comma that you find." Tliis output was then redirected to 
another file, which we had the mailing software (happily) 
read in. 

Don’t feel confuSED 

Just Learning the sed presented in this month's 
column will l>ring you incredible power on the 
command line and when editing files in batch or under 
the command of a shell script. Relieve il or not, there's 


more! If this was your first exposure to sed, practice, 
practice, practice! Get a test file (or two or three) and 
see wdnat sed does when you issue various commands. 
Next month, T'l) cover a little more on the quirky 
interactions, other commands and more advanced 
usage. 

While I normally say, 'see you next month/ and f 
mean 1n print/ 1 really do hope to see everyone next 
month in person: at MacWorld! I'll be there all week, 
and presenting the, 'Trom the Chime to the Desktop” 
session on Wednesday in the I'l' track conference. 
Please say hello if youll be in San Franci.scol Of course, 
ril still see everyone in print. Until then, let sed rip 
Through some files for you! 

Viii 
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flash and edit in real-time. 

Extreme Wireless. Wireless is great, unless you're getting slow 
transfers. Even Airport Extreme's are slow when the signal Is weak. 
Daystar can boost your signals and energize your wireless network. 

But, if You Really need a G5? Daystar is the only Mac Performance 


Manufacturer that is also an Apple Authorized Reseller. Not only can 
you trade-in your system for the latest and greatest... but the Daystar 
Pro's can upgrade it for maximum performance! 

Call 877-439-8646 and beat the clock. 


Authorized Reseller 


Daystar Technology - Your Macintosh Performance Shop 



5018 Bristol Industrial Way, #202, Buford, GA 30518 USA 
Toll Free: 877-439-8646 or 770-614-5400 


Daystar-Tech.com 


Daystar-Forum.com 


Daystar-Store.com 
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COMPRESS JPEGS UP TO 30% 
WITH NO QUALITY LOSS! 
BUILT FOR MAC OS X "TIGER" 
BACKUP TO .MAC, CD, & DVD 


A Division of Smith Micro Software 


Available from your favorite retailers and catalogs. Download StufFIt Expander for FREE at www.stuffit.com! 

Download a FREE trial version of Siufflt Standard Edition at www.allumo.com. For Information about Stufflt's industry-leading JPEG compression, please visit www.stuffit.com. 
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